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

Wikipedia / MediaWiki wikidata API

The wikidata API from Wikipedia / MediaWiki — 3 operation(s) for wikidata.

Wikipedia / MediaWiki wikidata API is one of 33 APIs that Wikipedia / MediaWiki publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include wikidata. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and pricing.

This API exposes 6 operations across 3 paths, and defines 19 schemas. It is described by OpenAPI 3.0.3, at version 1.45.

Requests are made against 5 base URLs: https://en.wikipedia.org/w, https://{lang}.wikipedia.org/w, https://commons.wikimedia.org/w, https://www.wikidata.org/w, https://www.mediawiki.org/w.

6 operations 3 paths 19 schemas 3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.45
Base URL
https://en.wikipedia.org/w/api.php
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Wikipedia / MediaWiki wikidata API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the cookie as {wiki}wikiUserID (CookieAuth).

  • BearerAuth — OAuth 2.0 bearer token from meta.wikimedia.org
  • CookieAuth — Session cookie obtained via action=login or action=clientlogin

Paths & Operations 6

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

wikidata 6
GET
/v2/wikidata/items/{identifier}
2 params → 200401403404422500
POST
/v2/wikidata/items/{identifier}
1 param body → 200401403404422500
GET
/v2/wikidata/properties/{identifier}
2 params → 200401403404422500
POST
/v2/wikidata/properties/{identifier}
1 param body → 200401403404422500
GET
/v2/wikidata/labels/{identifier}
2 params → 200401403404422500
POST
/v2/wikidata/labels/{identifier}
1 param body → 200401403404422500

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are wikidata_article (13 properties), wikidata_entity (7 properties), wikidata_statement (6 properties), project (5 properties). Each schema is shown below with its type and property counts.

wikidata_entity_property
object
3 properties 2 required
article_namespace
object
1 property
language
object
4 properties
event
object
3 properties
error
object
2 properties
wikidata_article
object
13 properties 6 required
wikidata_statement
object
Statement connecting a value to a Wikidata entity through a property. Each statement corresponds to a single claim on the Wikidata entity, and includes the val…
6 properties 6 required
wikidata_entity_reference_part
object
2 properties 2 required
wikidata_sitelinks
object
Mapping of this Wikidata item to other Wikimedia project site URLs
3 properties 3 required
wikidata_entity_statement_reference
object
Reference supporting a Wikidata statement
2 properties 2 required
wikidata_entity
object
7 properties 2 required
visibility
object
3 properties
license
object
3 properties
wikidata_entity_qualifier
object
Qualifier further describing or refining the value of a property in a statement
2 properties 2 required
project
object
5 properties
wikidata_statements
array
Array of statement objects for this property
wikidata_labels
object
key-value pairs with labels in different languages
wikidata_entity_value
object
This object represents the actual value in a statement or qualifier
4 properties 2 required
protection
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wikipedia-wikidata-api-openapi.yml Raw ↑

Other APIs Wikipedia / MediaWiki publishes across the network.

Wikipedia / MediaWiki articles API
Wikipedia / MediaWiki Authentication API
Wikipedia / MediaWiki batches API
Wikipedia / MediaWiki Citation API
Wikipedia / MediaWiki codes API
Wikipedia / MediaWiki Edit API
Wikipedia / MediaWiki Files API
Wikipedia / MediaWiki History API
Wikipedia / MediaWiki languages API
Wikipedia / MediaWiki Links API
Wikipedia / MediaWiki Math API
Wikipedia / MediaWiki Meta API