Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wikidata Statements API

Statement (claim) operations

Wikidata Statements API is one of 9 APIs that Wikidata publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Statements. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 1 JSON Schema.

This API exposes 4 operations across 2 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against 2 base URLs: https://www.wikidata.org/w/rest.php/wikibase/v0, https://www.wikidata.org/w/api.php.

4 operations 2 paths 3 schemas 1 DELETE2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://www.wikidata.org/w/rest.php/wikibase/v0
Authentication
OAuth 2.0, API Key
Resource Areas
1

Authentication & Security 2

Wikidata Statements API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes. An API key is passed in the cookie as wikidataSession (MediaWikiSession).

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Statements 4

Statement (claim) operations

GET
/entities/items/{item_id}/statements
Wikidata Get Statements for an Item
getItemStatements 2 params → 200404
POST
/entities/items/{item_id}/statements
Wikidata Add a Statement to an Item
addItemStatement 1 param body → 201
GET
/statements/{statement_id}
Wikidata Get a Single Statement
getStatement 1 param → 200
DELETE
/statements/{statement_id}
Wikidata Delete a Statement
deleteStatement 1 param body → 200404

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are Statement (6 properties), StatementCreate (6 properties), DataValue (2 properties). Each schema is shown below with its type and property counts.

DataValue
object
2 properties
StatementCreate
object
6 properties 2 required
Statement
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wikidata-statements-api-openapi.yml Raw ↑

Other APIs Wikidata publishes across the network.

MediaWiki Action API
SPARQL Query Service
Linked Data Interface
Recent Changes Event Stream
Wikidata Descriptions API
Wikidata Items API
Wikidata Labels API
Wikidata Properties API