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 Items API

Wikidata item (Q-entity) operations

Wikidata Items 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 Items. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 1 JSON Schema.

This API exposes 3 operations across 2 paths, and defines 7 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.

3 operations 2 paths 7 schemas 1 GET1 PATCH1 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 Items 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 3

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

Items 3

Wikidata item (Q-entity) operations

GET
/entities/items/{item_id}
Wikidata Get a Wikidata Item
getItem 2 params → 200304404
PATCH
/entities/items/{item_id}
Wikidata Update a Wikidata Item
patchItem 1 param body → 200400401403409
POST
/entities/items
Wikidata Create a New Wikidata Item
createItem body → 201400401

Schemas 7

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

StatementCreate
object
6 properties 2 required
PatchRequest
object
4 properties 1 required
Sitelink
object
3 properties
DataValue
object
2 properties
Item
object
7 properties
Statement
object
6 properties
ItemCreate
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wikidata-items-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 Labels API
Wikidata Properties API
Wikidata Statements API