Wikidata

Wikidata is a free, collaborative, multilingual knowledge graph hosted by the Wikimedia Foundation. It provides structured linked data for Wikipedia and other Wikimedia projects, as well as a public platform for anyone to read and edit. Wikidata exposes several APIs including a Wikibase REST API for entity read/write operations, the MediaWiki Action API for batch entity retrieval and editing, a SPARQL endpoint for complex graph queries, Linked Data URIs for individual entity access in multiple RDF formats, a real-time Server-Sent Events stream for change monitoring, and full database dumps for bulk data processing.

5 APIs 8 Features

Knowledge GraphLinked DataOpen DataSemantic WebSPARQLWikipedia

APIs

Wikibase REST API

The Wikibase REST API provides OpenAPI-based read and write operations for Wikidata entities (items and properties), including labels, descriptions, aliases, statements, sitelin...

MediaWiki Action API

The MediaWiki Action API provides batch entity retrieval, editing, and search for Wikidata via wbgetentities, wbsearchentities, wbeditentity, and other actions. Supports up to 5...

SPARQL Query Service

The Wikidata Query Service provides a SPARQL 1.1 endpoint at query.wikidata.org for running complex graph queries over the full Wikidata knowledge base. Supports federated queri...

Linked Data Interface

The Wikidata Linked Data Interface provides individual entity data via content negotiation at http://www.wikidata.org/entity/{QID}. Supports JSON, JSON-LD, RDF/XML, Turtle, and ...

Recent Changes Event Stream

The Wikimedia Event Stream provides real-time Server-Sent Events (SSE) for Wikidata changes, revision creations, and page events. Available at stream.wikimedia.org. Ideal for mo...

Collections

Wikidata REST API & MediaWiki API

OPEN

Pricing Plans

Wikidata Plans Pricing

2 plans

PLANS

Rate Limits

Wikidata Rate Limits

4 limits

RATE LIMITS

FinOps

Wikidata Finops

FINOPS

Features

Multilingual Support

All entities support labels, descriptions, and aliases in hundreds of languages via BCP 47 language codes.

Structured Statements

Every claim is modeled as a statement with property, value, rank, qualifiers, and references for full provenance.

Open License

All Wikidata content is released under CC0 1.0 Universal (Public Domain) — no attribution required.

SPARQL Graph Queries

Complex multi-hop queries over 100M+ entities via SPARQL 1.1 at query.wikidata.org with GeoSPARQL and time extensions.

Real-Time Event Streaming

Server-Sent Events at stream.wikimedia.org deliver real-time change notifications for Wikidata edits.

Multiple Serialization Formats

Entities available as JSON, JSON-LD, RDF/XML, Turtle, and N-Triples via content negotiation on Linked Data URIs.

Wikibase Federation

Wikidata is an instance of Wikibase; federated SPARQL queries can cross Wikibase instances including Wikimedia Commons.

Database Dumps

Full JSON and RDF/TTL database dumps refreshed weekly at dumps.wikimedia.org for local bulk processing.

Use Cases

Knowledge Graph Augmentation

Enrich private datasets with structured Wikidata facts — entities, dates, relationships — via item and SPARQL queries.

Fact-Checking and Verification

Retrieve canonical statements with references to verify biographical, geographic, or scientific claims in text.

Wikipedia Infobox Data

Power Wikipedia infoboxes and sister-project templates with live Wikidata entity data via the MediaWiki Action API.

NLP Entity Linking

Resolve named entities from natural language to Wikidata Q-IDs using wbsearchentities and SPARQL label lookups.

Semantic Search

Build ontology-aware search systems using Wikidata's P31 (instance of) and P279 (subclass of) property hierarchies.

Change Monitoring

Track real-time edits to Wikidata entities relevant to a domain using the SSE event stream.

Linked Open Data Publishing

Publish organizational data as Linked Open Data by aligning custom schemas to Wikidata properties and Q-IDs.

Integrations

Wikipedia

Wikidata powers structured data for all Wikipedia language editions via Lua modules and infobox templates.

Wikimedia Commons

Media files on Wikimedia Commons are described using Wikidata items via structured data on Commons.

OpenStreetMap

OSM features are linked to Wikidata via the wikidata=* tag, enabling geographic entity cross-referencing.

Scholia

Scholia is a Wikidata-based scholarly profile service that visualizes publications, authors, and institutions.

Reasonator

Reasonator renders human-readable pages for Wikidata items, integrating maps, timelines, and media.

Mix'n'match

Mix'n'match links Wikidata items to external databases (VIAF, ORCID, GND, etc.) for authority control.

OpenRefine

OpenRefine has a Wikidata reconciliation service and can batch-upload tabular data as Wikidata statements.

Semantic Vocabularies

Wikidata Context

10 classes · 27 properties

JSON-LD

API Governance Rules

Wikidata API Rules

33 rules · 12 errors 16 warnings 5 info

SPECTRAL

JSON Structure

Wikidata Data Value Structure

2 properties

JSON STRUCTURE

Wikidata Entity Structure

10 properties

JSON STRUCTURE

Wikidata Item Create Structure

6 properties

JSON STRUCTURE

Wikidata Item Structure

7 properties

JSON STRUCTURE

Wikidata Patch Request Structure

4 properties

JSON STRUCTURE

Wikidata Property Structure

5 properties

JSON STRUCTURE

Wikidata Sitelink Structure

3 properties

JSON STRUCTURE

Wikidata Statement Create Structure

6 properties

JSON STRUCTURE

Wikidata Statement Structure

6 properties

JSON STRUCTURE

Example Payloads

Wikidata Data Value Example

2 fields

EXAMPLE

Wikidata Entity Example

10 fields

EXAMPLE

Wikidata Item Create Example

6 fields

EXAMPLE

Wikidata Item Example

7 fields

EXAMPLE

Wikidata Patch Request Example

4 fields

EXAMPLE

Wikidata Property Example

5 fields

EXAMPLE

Wikidata Sitelink Example

3 fields

EXAMPLE

Wikidata Statement Create Example

6 fields

EXAMPLE

Wikidata Statement Example

6 fields

EXAMPLE

Resources

Documentation

GitHubOrganization

GitHubOrganization

GitHubRepository

GitHubRepository

TermsOfService

PrivacyPolicy

Authentication

SpectralRules

Sources

opencollection: 1.0.0
info:
  name: Wikidata REST API & MediaWiki API
  version: '1.0'
items:
- info:
    name: Items
    type: folder
  items:
  - info:
      name: Wikidata Get a Wikidata Item
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id
      headers:
      - name: If-None-Match
        value: ''
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
    docs: Returns a Wikidata item (Q-entity) with all its labels, descriptions, aliases, sitelinks, and statements in JSON
      format.
  - info:
      name: Wikidata Update a Wikidata Item
      type: http
    http:
      method: PATCH
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/authorize
        accessTokenUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Applies a JSON patch to update an item. Requires authentication via OAuth2 or bot password. Includes edit comment
      and tags.
  - info:
      name: Wikidata Create a New Wikidata Item
      type: http
    http:
      method: POST
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/authorize
        accessTokenUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Creates a new Wikidata item with provided labels, descriptions, aliases, and statements.
- info:
    name: Labels
    type: folder
  items:
  - info:
      name: Wikidata Get a Label for an Item
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id/labels/:language_code
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      - name: language_code
        value: en
        type: path
        description: BCP 47 language code
    docs: Returns the label for a Wikidata item in a specific language.
  - info:
      name: Wikidata Set a Label for an Item
      type: http
    http:
      method: PUT
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id/labels/:language_code
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      - name: language_code
        value: en
        type: path
        description: BCP 47 language code
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/authorize
        accessTokenUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Sets or replaces the label for a Wikidata item in the specified language.
- info:
    name: Descriptions
    type: folder
  items:
  - info:
      name: Wikidata Get a Description for an Item
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id/descriptions/:language_code
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      - name: language_code
        value: en
        type: path
        description: BCP 47 language code
    docs: Returns the description for a Wikidata item in a specific language.
- info:
    name: Statements
    type: folder
  items:
  - info:
      name: Wikidata Get Statements for an Item
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id/statements
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      - name: property
        value: P31
        type: query
        description: Filter statements by property ID
    docs: Returns all statements (claims) for a Wikidata item, optionally filtered by property. Statements include main snak,
      qualifiers, and references.
  - info:
      name: Wikidata Add a Statement to an Item
      type: http
    http:
      method: POST
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/items/:item_id/statements
      params:
      - name: item_id
        value: Q42
        type: path
        description: Wikidata item ID
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/authorize
        accessTokenUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Adds a new statement (claim) to a Wikidata item.
  - info:
      name: Wikidata Get a Single Statement
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/statements/:statement_id
      params:
      - name: statement_id
        value: Q42$F078E5B3-F9A8-480E-B7AC-D97778CBBEF9
        type: path
        description: Statement ID (Q{itemId}${guid})
    docs: Returns a single statement by its globally unique statement ID.
  - info:
      name: Wikidata Delete a Statement
      type: http
    http:
      method: DELETE
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/statements/:statement_id
      params:
      - name: statement_id
        value: Q42$F078E5B3-F9A8-480E-B7AC-D97778CBBEF9
        type: path
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/authorize
        accessTokenUrl: https://www.mediawiki.org/w/index.php?title=Special:OAuth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Removes a statement from its parent item.
- info:
    name: Properties
    type: folder
  items:
  - info:
      name: Wikidata Get a Wikidata Property
      type: http
    http:
      method: GET
      url: https://www.wikidata.org/w/rest.php/wikibase/v0/entities/properties/:property_id
      params:
      - name: property_id
        value: P31
        type: path
        description: Wikidata property ID
    docs: Returns a Wikidata property (P-entity) with labels, descriptions, and statements.
bundled: true