wikidata_article

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/enterprise-wikimedia-com/json-schema/enterprise-wikimedia-com-wikidata-article-schema.json",
  "title": "wikidata_article",
  "description": "Wikidata entity page returned by the Wikidata endpoints.\n\nBeta: these endpoints are experimental, are not covered by an SLA, and are not recommended for production. Fields and shapes can change as the endpoints develop, and they graduate into the production endpoints once they are ready.\n",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/enterprise-wikimedia-com-openapi.yml#/components/schemas/wikidata_article",
  "type": "object",
  "required": [
    "name",
    "identifier",
    "url",
    "license"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Wikidata item identifier (Q-number, e.g. Q42), or property identifier (P-number, e.g. P31)"
    },
    "identifier": {
      "type": "integer",
      "description": "Unique numeric identifier of the entity's page. This is the MediaWiki page ID, distinct from the entity identifier in `name`"
    },
    "date_created": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of when the entity's page was first created"
    },
    "date_modified": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of when the entity's page was last modified"
    },
    "date_previously_modified": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of the before-last revision"
    },
    "protection": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/protection"
      },
      "description": "Protections restricting who can edit or move the entity's page. Current payloads do not carry this field, including for protected pages"
    },
    "redirects": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/redirect"
      },
      "description": "Pages that redirect to this entity's page. Current payloads do not carry this field"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the entity's page on Wikidata"
    },
    "namespace": {
      "$ref": "#/$defs/article_namespace",
      "description": "Namespace of the page holding the entity"
    },
    "is_part_of": {
      "$ref": "#/$defs/project",
      "description": "Project the entity belongs to"
    },
    "entity": {
      "$ref": "#/$defs/wikidata_entity",
      "description": "The Wikidata entity itself"
    },
    "visibility": {
      "$ref": "#/$defs/visibility"
    },
    "license": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/license"
      },
      "description": "Licenses that apply to the entity data"
    },
    "event": {
      "$ref": "#/$defs/event"
    },
    "version": {
      "$ref": "#/$defs/wikidata_version",
      "description": "The revision of the entity page this payload represents"
    },
    "previous_version": {
      "$ref": "#/$defs/wikidata_previous_version"
    }
  },
  "$defs": {
    "article_namespace": {
      "type": "object",
      "description": "Namespace the page belongs to",
      "properties": {
        "identifier": {
          "type": "number",
          "description": "Numeric identifier of the namespace. Names and descriptions are available from the Namespaces metadata endpoints"
        }
      }
    },
    "editor": {
      "description": "Editor who made the revision, with signals that help contextualize their activity",
      "properties": {
        "date_started": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of when the editor's account was registered. Anonymous editors (from before temporary accounts) carry the zero value `0001-01-01T00:00:00Z` rather than a real date"
        },
        "edit_count": {
          "type": "integer",
          "description": "Number of edits the editor has made"
        },
        "groups": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Editor groups the editor belongs to, such as `autoconfirmed` or `bot`"
        },
        "identifier": {
          "type": "integer",
          "description": "Unique MediaWiki identifier of the editor. Absent for anonymous editors"
        },
        "is_anonymous": {
          "type": "boolean",
          "description": "Whether the editor is anonymous. Since December 2025 all Wikimedia projects except Russian Wikipedia replaced anonymous editing with temporary accounts, so on those projects `is_anonymous` is always `false` and omitted"
        },
        "is_bot": {
          "type": "boolean",
          "description": "Whether the editor is a bot"
        },
        "name": {
          "type": "string",
          "description": "Username of the editor, which may be removed if deemed vandalism. For anonymous editors this is the editor's IP address. For [temporary accounts](https://en.wikipedia.org/wiki/Wikipedia:Temporary_accounts) it is a tilde, the account's creation year, and an auto-generated serial number in 5-digit groups, e.g. `~2026-59431-3`"
        },
        "is_admin": {
          "type": "boolean",
          "description": "Whether the editor has admin status"
        },
        "is_patroller": {
          "type": "boolean",
          "description": "Whether the editor has patroller status"
        },
        "has_advanced_rights": {
          "type": "boolean",
          "description": "Whether the editor has advanced rights"
        }
      },
      "type": "object"
    },
    "event": {
      "type": "object",
      "description": "Event that triggered the change to the article or entity",
      "properties": {
        "identifier": {
          "type": "string",
          "description": "UUID of the event, usable to trace it through the Wikimedia Enterprise pipeline"
        },
        "type": {
          "type": "string",
          "description": "Type of event:\n- `update` - the article or entity changed\n- `delete` - the article or entity was deleted\n- `visibility-change` - the visibility of a revision changed; Realtime API only",
          "enum": [
            "update",
            "delete",
            "visibility-change"
          ]
        },
        "date_created": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of when the event entered the Wikimedia Enterprise pipeline"
        },
        "date_published": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of when the event was published to its partition. Realtime API only"
        },
        "partition": {
          "type": "integer",
          "description": "Partition of the event stream the event belongs to. Realtime API only"
        },
        "offset": {
          "type": "integer",
          "description": "Position of the event within its partition, increasing with each event. Realtime API only"
        }
      }
    },
    "language": {
      "type": "object",
      "description": "Language of a Wikimedia project or article",
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Wikimedia [language code](https://www.wikidata.org/wiki/Help:Wikimedia_language_codes/lists/all) of the language"
        },
        "name": {
          "type": "string",
          "description": "Full name of the language"
        },
        "alternate_name": {
          "type": "string",
          "description": "Alternate name of the language"
        },
        "direction": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "ltr",
            "rtl",
            null
          ],
          "description": "Direction the language is written in, `ltr` (left-to-right) or `rtl` (right-to-left)"
        }
      }
    },
    "license": {
      "type": "object",
      "description": "License that applies to the article content",
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Unique identifier of the license"
        },
        "name": {
          "type": "string",
          "description": "Name of the license"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "URL of the license description"
        }
      }
    },
    "project": {
      "type": "object",
      "description": "Wikimedia project a resource belongs to",
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Unique identifier of the project, combining language and project code, e.g. `enwiki` for English Wikipedia"
        },
        "code": {
          "type": "string",
          "description": "Code of the project type, e.g. `wiki` for Wikipedia projects"
        },
        "name": {
          "type": "string",
          "description": "Name of the project"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "URL of the project"
        },
        "in_language": {
          "$ref": "#/$defs/language",
          "description": "Primary language of the project"
        }
      }
    },
    "protection": {
      "type": "object",
      "description": "Protection restricting who can perform an action on the article",
      "properties": {
        "expiry": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "infinite",
                "indefinite",
                "infinity",
                "never"
              ]
            },
            {
              "type": "string",
              "format": "date-time"
            }
          ],
          "description": "When the protection expires. One of the sentinel values `infinite`, `indefinite`, `infinity`, or `never` for protections that do not expire, otherwise a timestamp"
        },
        "level": {
          "type": "string",
          "description": "Editor status required to perform the action, such as `autoconfirmed` or `sysop`. The set of levels is project-specific"
        },
        "type": {
          "type": "string",
          "description": "Action the protection applies to, such as `edit` or `move`. The [siteinfo restrictions API](https://www.mediawiki.org/wiki/API:Siteinfo#Restrictions) lists each project's protection types and levels"
        }
      }
    },
    "redirect": {
      "description": "Article that redirects to this article",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the redirecting article, often an alternate spelling or a related title consolidated into this article"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "URL of the redirecting article"
        }
      },
      "type": "object"
    },
    "revertrisk": {
      "description": "Prediction of whether the revision may be reverted",
      "properties": {
        "prediction": {
          "type": "boolean",
          "description": "Whether the model predicts the revision will be reverted. Omitted when `false`"
        },
        "probability": {
          "description": "Model probabilities behind the prediction",
          "properties": {
            "false": {
              "type": "number",
              "description": "Probability that the revision will not be reverted, between 0 and 1. Omitted when `0.0`"
            },
            "true": {
              "type": "number",
              "description": "Probability that the revision will be reverted, between 0 and 1. Omitted when `0.0`"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "visibility": {
      "type": "object",
      "description": "Whether parts of this revision are visible. When the editing community flags a revision as containing potentially damaging content, it hides the affected part; `false` indicates the hidden part. Present only on `visibility-change` events in the Realtime API",
      "properties": {
        "comment": {
          "type": "boolean",
          "description": "Whether the edit comment of the revision is visible"
        },
        "text": {
          "type": "boolean",
          "description": "Whether the text of the revision is visible"
        },
        "editor": {
          "type": "boolean",
          "description": "Whether the editor name of the revision is visible"
        }
      }
    },
    "wikidata_entity": {
      "type": "object",
      "description": "Wikidata entity data: labels, descriptions, aliases, statements, and sitelinks. Statements connect values to the entity through properties; qualifiers refine a statement and references support it",
      "required": [
        "identifier",
        "type"
      ],
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Wikidata item identifier (Q-number, e.g. Q42), or property identifier (P-number, e.g. P31)"
        },
        "type": {
          "type": "string",
          "enum": [
            "item",
            "property"
          ],
          "description": "The type of entity, either \"item\" or \"property\""
        },
        "labels": {
          "$ref": "#/$defs/wikidata_labels"
        },
        "descriptions": {
          "type": "object",
          "description": "Key-value pairs with descriptions in different languages"
        },
        "aliases": {
          "type": "object",
          "description": "Key-value pairs with aliases in different languages. Every language may have multiple aliases"
        },
        "statements": {
          "$ref": "#/$defs/wikidata_statement_map"
        },
        "sitelinks": {
          "$ref": "#/$defs/wikidata_sitelinks"
        }
      }
    },
    "wikidata_entity_property": {
      "type": "object",
      "description": "Wikidata property used in a statement, qualifier, or reference part",
      "required": [
        "identifier",
        "data_type"
      ],
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Wikidata Property identifier (P-number, e.g. P31)."
        },
        "data_type": {
          "type": "string",
          "description": "Expected data type of the value for this property, e.g. `time`, `quantity`, `wikibase-item`, `url`, `string`. The actual type of the delivered value is in the statement's `value.type`"
        },
        "labels": {
          "type": "object",
          "description": "Labels of the property keyed by Wikimedia language code. Within statement data a single language is returned"
        }
      }
    },
    "wikidata_entity_qualifier": {
      "type": "object",
      "description": "Qualifier further describing or refining the value of a property in a statement",
      "required": [
        "property",
        "value"
      ],
      "properties": {
        "property": {
          "$ref": "#/$defs/wikidata_entity_property"
        },
        "value": {
          "$ref": "#/$defs/wikidata_entity_value"
        }
      }
    },
    "wikidata_entity_reference_part": {
      "type": "object",
      "description": "Part of a reference, pairing a property with its value",
      "required": [
        "property",
        "value"
      ],
      "properties": {
        "property": {
          "description": "Property this reference part refers to, in the same shape as a statement's `property`",
          "$ref": "#/$defs/wikidata_entity_property"
        },
        "value": {
          "description": "Value of the reference part, in the same shape as a statement's `value`",
          "$ref": "#/$defs/wikidata_entity_value"
        }
      }
    },
    "wikidata_entity_statement_reference": {
      "type": "object",
      "description": "Reference supporting a Wikidata statement",
      "required": [
        "identifier",
        "parts"
      ],
      "properties": {
        "identifier": {
          "type": "string",
          "description": "unique identifier for the reference"
        },
        "parts": {
          "type": "array",
          "description": "Parts that make up this reference",
          "items": {
            "$ref": "#/$defs/wikidata_entity_reference_part"
          }
        }
      }
    },
    "wikidata_entity_value": {
      "type": "object",
      "description": "This object represents the actual value in a statement or qualifier",
      "required": [
        "type"
      ],
      "properties": {
        "content": {
          "type": "string",
          "description": "String representation of the value. When the value is too complex to represent as a string or integer, `content_data` holds it instead"
        },
        "type": {
          "type": "string",
          "description": "Actual data type of the delivered value. Usually matches the property's `data_type`, but can differ"
        },
        "content_data": {
          "type": "object",
          "description": "Object representation of the value. When the value can be represented as a simple string or integer, `content` holds it instead"
        },
        "labels": {
          "$ref": "#/$defs/wikidata_labels"
        }
      }
    },
    "wikidata_labels": {
      "type": "object",
      "description": "Labels keyed by Wikimedia language code"
    },
    "wikidata_previous_version": {
      "type": "object",
      "description": "Metadata related to the before-last revision of the entity",
      "required": [
        "identifier"
      ],
      "properties": {
        "identifier": {
          "type": "integer",
          "description": "Identifier of the previous revision"
        },
        "number_of_characters": {
          "type": "integer",
          "description": "Number of characters in the previous revision"
        },
        "namespace": {
          "$ref": "#/$defs/article_namespace",
          "description": "Namespace of the page holding the entity"
        }
      }
    },
    "wikidata_sitelink": {
      "type": "object",
      "description": "One sitelink, the entity's page on one Wikimedia project",
      "required": [
        "title",
        "badges",
        "url"
      ],
      "properties": {
        "title": {
          "type": "string",
          "description": "Title of the linked page"
        },
        "badges": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Badge identifiers for this sitelink"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "URL to the linked page"
        }
      }
    },
    "wikidata_sitelinks": {
      "type": "object",
      "description": "Sitelinks keyed by project identifier, such as `enwiki` or `frwikivoyage`. Each value links the entity to its page on that project",
      "additionalProperties": {
        "$ref": "#/$defs/wikidata_sitelink"
      }
    },
    "wikidata_statement": {
      "type": "object",
      "description": "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 value of the claim and metadata about the claim such as references, qualifiers, and ranks",
      "required": [
        "identifier",
        "rank",
        "property",
        "value",
        "qualifiers",
        "references"
      ],
      "properties": {
        "identifier": {
          "type": "string",
          "description": "Unique identifier for the statement"
        },
        "rank": {
          "type": "string",
          "description": "Rank of the statement among other similar statements. Possible values are normal, preferred, and deprecated",
          "enum": [
            "normal",
            "preferred",
            "deprecated"
          ]
        },
        "property": {
          "$ref": "#/$defs/wikidata_entity_property"
        },
        "value": {
          "$ref": "#/$defs/wikidata_entity_value"
        },
        "qualifiers": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/wikidata_entity_qualifier"
          },
          "description": "Qualifiers refining this statement's value, such as a point in time or a source scope. `null` when the statement has no qualifiers"
        },
        "references": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/wikidata_entity_statement_reference"
          },
          "description": "References supporting this statement. `null` when the statement carries no references"
        }
      }
    },
    "wikidata_statement_map": {
      "type": "object",
      "description": "Statements on the entity, keyed by Wikidata property ID (PID). Each key is a P-number (e.g. `P31`) whose value is the array of statement objects for that property. Only P-number keys are permitted.",
      "patternProperties": {
        "^P\\d+$": {
          "$ref": "#/$defs/wikidata_statements"
        }
      },
      "additionalProperties": false
    },
    "wikidata_statements": {
      "type": "array",
      "description": "Array of statement objects for this property",
      "items": {
        "$ref": "#/$defs/wikidata_statement"
      }
    },
    "wikidata_version": {
      "type": "object",
      "description": "The revision of the Wikidata entity page this payload represents",
      "required": [
        "identifier"
      ],
      "properties": {
        "identifier": {
          "type": "integer",
          "description": "Revision identifier, unique within Wikidata and increasing with every edit"
        },
        "comment": {
          "type": "string",
          "description": "Edit summary left by the editor"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Change tags MediaWiki attached to the revision"
        },
        "is_minor_edit": {
          "type": "boolean",
          "description": "Whether the editor marked the revision as minor"
        },
        "editor": {
          "$ref": "#/$defs/editor"
        },
        "scores": {
          "type": "object",
          "description": "Model scores for the revision. Wikidata revisions carry RevertRisk only",
          "properties": {
            "revertrisk": {
              "$ref": "#/$defs/revertrisk"
            }
          }
        }
      }
    }
  }
}