Snapshot API Documentation
Our Snapshot API provides you the entirety of a Wikimedia project (examples: English Wikipedia or French Wiktionary) in a compressed tarball (.tar.gz) that contains a single .ndjson file. This file holds all articles (pages), with all data fields, in Newline-Delimited JSON format. Updated once a month, on the 1st day of the month, these snapshots are provided free with an account. You also get free access to Structured Contents snapshots. If you need fresher data, you can get access to up to daily snapshot updates by contacting Sales.
Use our metadata endpoints to find the project snapshot(s) you need and make use of parallel downloading headers or chunking to break up large files. Feel free to reference our Data Dictionary for information about the fields in the payload.
Note: Snapshots, structured-contents snapshots, and chunks may contain a small amount of duplicate articles (< 1%). Similarly, they may contain a small amount of deleted articles.
When encountering more than one instance of an article, please use the one with the highest version.identifier number. This will be the latest among the duplicates.
When encountering deleted articles, please download the successive snapshots. The deleted articles will be removed in the successive generation of these snapshots/structured-contents snapshots/chunks.
Snapshots Available
Returns a list of available project snapshots by namespace. Includes identifiers, file sizes and other relevant metadata.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported. filters- array
- Optional
- Select which projects and languages to receive in your response. Sent as one
filtersquery parameter per filter, each a JSON object:?filters={"field":"is_part_of.identifier","value":"enwiki"}&filters={"field":"namespace.identifier","value":0}. Repeated filters combine as AND. A JSON array in a single value returns422 Unprocessable Entity.
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
fields- array
filters- array
application/json{ "fields": [ "name", "identifier" ], "filters": [ { "field": "namespace.identifier", "value": 0 } ] }
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Snapshot Info
Information on a specific Snapshot bundle. Includes identifiers, file sizes and other relevant metadata.
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
fields- array
application/json{ "fields": [ "name", "identifier" ] }
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Snapshot Download
Downloadable bundle of all current revisions in a specified project and namespace. Updated daily at 00:00 UTC.
Responds 307 Temporary Redirect with a presigned URL in the Location header, valid for 60 seconds. The file is served from that URL, not from this endpoint, so clients must follow the redirect (for example curl --location) and request a fresh URL for each download rather than storing one. Do not send the API bearer token to the presigned URL: the storage service rejects a request that carries both with 400 InvalidArgument. The payload is a gzipped tar archive served as binary/octet-stream. Use HEAD on this path for Content-Length, ETag, Last-Modified and Accept-Ranges, and send Range requests to the presigned URL to resume a partial download.
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Range- string
- Optional
- The Range HTTP request header indicates the part of a document that the server should return. This endpoint redirects before reading it, so send
Rangeto the presigned URL in the redirect instead.
-
binary/octet-stream
{} -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Set of headers that describe the snapshot download.
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
-
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Snapshot Chunks Available
Returns a list of available chunks for a specific snapshot. Includes chunk identifiers and other relevant metadata.
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported. filters- array
- Optional
- Select which projects and languages to receive in your response. Sent as one
filtersquery parameter per filter, each a JSON object:?filters={"field":"is_part_of.identifier","value":"enwiki"}&filters={"field":"namespace.identifier","value":0}. Repeated filters combine as AND. A JSON array in a single value returns422 Unprocessable Entity.
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" } } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
fields- array
filters- array
application/json{ "fields": [ "name", "identifier" ], "filters": [ { "field": "identifier", "value": "hiwiki_namespace_0_chunk_0" } ] }
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" } } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Snapshot Chunk Info
Information on a specific chunk of a snapshot. Includes chunk identifier, size, and other relevant metadata.
snapshot_identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration. chunk_identifier- string
- Required
- Chunk identifier or index.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" } } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
snapshot_identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration. chunk_identifier- string
- Required
- Chunk identifier or index.
fields- array
application/json{ "fields": [ "name", "identifier" ] }
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" } } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Snapshot Chunk Download
Downloadable bundle of a specific chunk from a snapshot. Returns a zipped tar file.
Responds 307 Temporary Redirect with a presigned URL in the Location header, valid for 60 seconds. The file is served from that URL, not from this endpoint, so clients must follow the redirect (for example curl --location) and request a fresh URL for each download rather than storing one. Do not send the API bearer token to the presigned URL: the storage service rejects a request that carries both with 400 InvalidArgument. The payload is a gzipped tar archive served as binary/octet-stream. Use HEAD on this path for Content-Length, ETag, Last-Modified and Accept-Ranges, and send Range requests to the presigned URL to resume a partial download.
snapshot_identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration. chunk_identifier- string
- Required
- Chunk identifier or index.
Range- string
- Optional
- The Range HTTP request header indicates the part of a document that the server should return. This endpoint redirects before reading it, so send
Rangeto the presigned URL in the redirect instead.
-
binary/octet-stream
{} -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Set of headers that describe the snapshot chunk download.
snapshot_identifier- string
- Required
- Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_14downloads categories used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org,frwikivoyage_namespace_10downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration. chunk_identifier- string
- Required
- Chunk identifier or index.
-
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshots Available (Beta)
Returns a list of available wikidata project snapshots (currently 'items' and 'properties'). Includes identifiers, file sizes and other relevant metadata.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported. filters- array
- Optional
- Select which projects and languages to receive in your response. Sent as one
filtersquery parameter per filter, each a JSON object:?filters={"field":"is_part_of.identifier","value":"enwiki"}&filters={"field":"namespace.identifier","value":0}. Repeated filters combine as AND. A JSON array in a single value returns422 Unprocessable Entity.
-
application/json
[ { "identifier": "wikidata_items", "version": "40c73f0d30f6c16561d4efa9b9b96357", "date_modified": "2026-09-09T02:27:12.038383254Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 105144.214, "unit_text": "MB" }, "chunks": [ "wikidata_items_chunk_0", "wikidata_items_chunk_1" ], "record_count": 75779844 }, { "identifier": "wikidata_properties", "version": "417623065361bf04f3678a186f0617ae", "date_modified": "2026-09-09T02:27:17.204541641Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 120 }, "size": { "value": 45.596, "unit_text": "MB" }, "chunks": [ "wikidata_properties_chunk_0" ], "record_count": 16072 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
fields- array
filters- array
application/json{ "fields": [ "name", "identifier" ], "filters": [ { "field": "namespace.identifier", "value": 0 } ] }
-
application/json
[ { "identifier": "wikidata_items", "version": "40c73f0d30f6c16561d4efa9b9b96357", "date_modified": "2026-09-09T02:27:12.038383254Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 105144.214, "unit_text": "MB" }, "chunks": [ "wikidata_items_chunk_0", "wikidata_items_chunk_1" ], "record_count": 75779844 }, { "identifier": "wikidata_properties", "version": "417623065361bf04f3678a186f0617ae", "date_modified": "2026-09-09T02:27:17.204541641Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 120 }, "size": { "value": 45.596, "unit_text": "MB" }, "chunks": [ "wikidata_properties_chunk_0" ], "record_count": 16072 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshot Info (Beta)
Information on a specific Wikidata Snapshot. Includes identifiers, file sizes and other relevant metadata.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
-
application/json
{ "identifier": "wikidata_items", "version": "40c73f0d30f6c16561d4efa9b9b96357", "date_modified": "2026-09-09T02:27:12.038383254Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 105144.214, "unit_text": "MB" }, "chunks": [ "wikidata_items_chunk_0", "wikidata_items_chunk_1" ], "record_count": 75779844 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
fields- array
application/json{ "fields": [ "name", "identifier" ] }
-
application/json
{ "identifier": "wikidata_items", "version": "40c73f0d30f6c16561d4efa9b9b96357", "date_modified": "2026-09-09T02:27:12.038383254Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 105144.214, "unit_text": "MB" }, "chunks": [ "wikidata_items_chunk_0", "wikidata_items_chunk_1" ], "record_count": 75779844 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshot Download (Beta)
Downloadable bundle of all current Main Graph 'items' or all current 'properties' from Wikidata. Updated daily at 00:00 UTC.
Responds 307 Temporary Redirect with a presigned URL in the Location header, valid for 60 seconds. The file is served from that URL, not from this endpoint, so clients must follow the redirect (for example curl --location) and request a fresh URL for each download rather than storing one. Do not send the API bearer token to the presigned URL: the storage service rejects a request that carries both with 400 InvalidArgument. The payload is a gzipped tar archive served as binary/octet-stream. Use HEAD on this path for Content-Length, ETag, Last-Modified and Accept-Ranges, and send Range requests to the presigned URL to resume a partial download.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Range- string
- Optional
- The Range HTTP request header indicates the part of a document that the server should return. This endpoint redirects before reading it, so send
Rangeto the presigned URL in the redirect instead.
-
binary/octet-stream
{} -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Set of headers that describe the Wikidata Snapshot download.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
-
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshot Chunks Available (Beta)
Returns a list of available chunks for a specific Wikidata snapshot. Includes chunk identifiers and other relevant metadata.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported. filters- array
- Optional
- Select which projects and languages to receive in your response. Sent as one
filtersquery parameter per filter, each a JSON object:?filters={"field":"is_part_of.identifier","value":"enwiki"}&filters={"field":"namespace.identifier","value":0}. Repeated filters combine as AND. A JSON array in a single value returns422 Unprocessable Entity.
-
application/json
[ { "identifier": "wikidata_items_chunk_0", "version": "9798a054e03c5d23575cf92dcd2b6e4f", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 376.203, "unit_text": "MB" } }, { "identifier": "wikidata_items_chunk_1", "version": "1f0c2ab9d2f2f2f8a6f0a3a3b5f5e9d1", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 374.88, "unit_text": "MB" } } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
fields- array
filters- array
application/json{ "fields": [ "name", "identifier" ], "filters": [ { "field": "identifier", "value": "wikidata_items_chunk_0" } ] }
-
application/json
[ { "identifier": "wikidata_items_chunk_0", "version": "9798a054e03c5d23575cf92dcd2b6e4f", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 376.203, "unit_text": "MB" } }, { "identifier": "wikidata_items_chunk_1", "version": "1f0c2ab9d2f2f2f8a6f0a3a3b5f5e9d1", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 374.88, "unit_text": "MB" } } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshot Chunk Info (Beta)
Information on a specific chunk of a Wikidata snapshot. Includes chunk identifier, size, and other relevant metadata.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
chunk_identifier- string
- Required
- Chunk identifier or index.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
-
application/json
{ "identifier": "wikidata_items_chunk_0", "version": "9798a054e03c5d23575cf92dcd2b6e4f", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 376.203, "unit_text": "MB" } } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
chunk_identifier- string
- Required
- Chunk identifier or index.
fields- array
application/json{ "fields": [ "name", "identifier" ] }
-
application/json
{ "identifier": "wikidata_items_chunk_0", "version": "9798a054e03c5d23575cf92dcd2b6e4f", "date_modified": "2026-09-09T00:01:18.35113202Z", "is_part_of": { "identifier": "wikidatawiki" }, "in_language": { "identifier": "en" }, "namespace": { "identifier": 0 }, "size": { "value": 376.203, "unit_text": "MB" } } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Wikidata Snapshot Chunk Download (Beta)
Downloadable bundle of a specific chunk from a Wikidata snapshot. Returns a zipped tar file.
Responds 307 Temporary Redirect with a presigned URL in the Location header, valid for 60 seconds. The file is served from that URL, not from this endpoint, so clients must follow the redirect (for example curl --location) and request a fresh URL for each download rather than storing one. Do not send the API bearer token to the presigned URL: the storage service rejects a request that carries both with 400 InvalidArgument. The payload is a gzipped tar archive served as binary/octet-stream. Use HEAD on this path for Content-Length, ETag, Last-Modified and Accept-Ranges, and send Range requests to the presigned URL to resume a partial download.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
chunk_identifier- string
- Required
- Chunk identifier or index.
Range- string
- Optional
- The Range HTTP request header indicates the part of a document that the server should return. This endpoint redirects before reading it, so send
Rangeto the presigned URL in the redirect instead.
-
binary/octet-stream
{} -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Set of headers that describe the Wikidata snapshot chunk download.
identifier- string
- Required
- One of:
itemsproperties - Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
chunk_identifier- string
- Required
- Chunk identifier or index.
-
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Structured Contents Snapshots Available (Beta)
Returns a list of available project structured contents snapshots.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported. filters- array
- Optional
- Select which projects and languages to receive in your response. Sent as one
filtersquery parameter per filter, each a JSON object:?filters={"field":"is_part_of.identifier","value":"enwiki"}&filters={"field":"namespace.identifier","value":0}. Repeated filters combine as AND. A JSON array in a single value returns422 Unprocessable Entity.
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
fields- array
filters- array
application/json{ "fields": [ "name", "identifier" ], "filters": [ { "field": "is_part_of.identifier", "value": "enwiki" } ] }
-
application/json
[ { "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } ] -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Structured Contents Snapshot Info (Beta)
Information on a specific structured contents snapshot bundle.
identifier- string
- Required
- Structured Contents Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_0downloads structured_contents used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org. Note: the Structured Contents Beta supports nine projects:enwiki_namespace_0,dewiki_namespace_0,frwiki_namespace_0,eswiki_namespace_0,ptwiki_namespace_0,itwiki_namespace_0,nlwiki_namespace_0,cywiki_namespace_0, andidwiki_namespace_0.
fields- array
- Optional
- Select which fields to receive in your response, using JSON dot notation. Sent as one
fieldsquery parameter per field:?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
identifier- string
- Required
- Structured Contents Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_0downloads structured_contents used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org. Note: the Structured Contents Beta supports nine projects:enwiki_namespace_0,dewiki_namespace_0,frwiki_namespace_0,eswiki_namespace_0,ptwiki_namespace_0,itwiki_namespace_0,nlwiki_namespace_0,cywiki_namespace_0, andidwiki_namespace_0.
fields- array
application/json{ "fields": [ "name", "identifier" ] }
-
application/json
{ "identifier": "string", "version": "string", "date_modified": "string", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" }, "is_part_of": { "identifier": "enwiki", "code": "wiki", "name": "Wikipedia", "url": "https://en.wikipedia.org", "in_language": { "identifier": "en", "name": "English", "alternate_name": "English", "direction": "ltr" } }, "namespace": { "identifier": 0 }, "size": { "unit_text": "string", "value": "number" }, "chunks": "array", "record_count": 3943117 } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Structured Contents Snapshot Download (Beta)
Downloadable bundle of structured contents of all current revisions in a specified project and namespace. Updated daily at 00:00 UTC.
Responds 307 Temporary Redirect with a presigned URL in the Location header, valid for 60 seconds. The file is served from that URL, not from this endpoint, so clients must follow the redirect (for example curl --location) and request a fresh URL for each download rather than storing one. Do not send the API bearer token to the presigned URL: the storage service rejects a request that carries both with 400 InvalidArgument. The payload is a gzipped tar archive served as binary/octet-stream. Use HEAD on this path for Content-Length, ETag, Last-Modified and Accept-Ranges, and send Range requests to the presigned URL to resume a partial download.
identifier- string
- Required
- Structured Contents Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_0downloads structured_contents used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org. Note: the Structured Contents Beta supports nine projects:enwiki_namespace_0,dewiki_namespace_0,frwiki_namespace_0,eswiki_namespace_0,ptwiki_namespace_0,itwiki_namespace_0,nlwiki_namespace_0,cywiki_namespace_0, andidwiki_namespace_0.
Range- string
- Optional
- The Range HTTP request header indicates the part of a document that the server should return. This endpoint redirects before reading it, so send
Rangeto the presigned URL in the redirect instead.
-
binary/octet-stream
{} -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
Set of headers that describe the structured contents snapshot download.
identifier- string
- Required
- Structured Contents Snapshot identifier looks like
<language><project_name>_namespace_<number>, examples:dewiki_namespace_0downloads structured_contents used in de.wikipedia.org,enwiki_namespace_0downloads articles used in en.wikipedia.org. Note: the Structured Contents Beta supports nine projects:enwiki_namespace_0,dewiki_namespace_0,frwiki_namespace_0,eswiki_namespace_0,ptwiki_namespace_0,itwiki_namespace_0,nlwiki_namespace_0,cywiki_namespace_0, andidwiki_namespace_0.
-
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" } -
application/json
{ "message": "string", "status": "integer" }
