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.

GET https://api.enterprise.wikimedia.com/v2/snapshots
Parameters
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query 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 filters query 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 returns 422 Unprocessable Entity.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots
Request Body
fields
array
filters
array
application/json
{ "fields": [ "name", "identifier" ], "filters": [ { "field": "namespace.identifier", "value": 0 } ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}
Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query parameter per field: ?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}
Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Request Body
fields
array
application/json
{ "fields": [ "name", "identifier" ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}/download

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.

Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Header parameters
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 Range to the presigned URL in the redirect instead.
Response
  • 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" }
HEAD https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}/download

Set of headers that describe the snapshot download.

Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}/chunks
Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query 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 filters query 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 returns 422 Unprocessable Entity.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/{identifier}/chunks
Parameters
Path parameters
identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads wikitext templates used in fr.wikivoyage.org. See our Metadata Endpoints for language, projects, and namespaces available for configuration.
Request Body
fields
array
filters
array
application/json
{ "fields": [ "name", "identifier" ], "filters": [ { "field": "identifier", "value": "hiwiki_namespace_0_chunk_0" } ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/{snapshot_identifier}/chunks/{chunk_identifier}
Parameters
Path parameters
snapshot_identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads 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.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query parameter per field: ?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/{snapshot_identifier}/chunks/{chunk_identifier}
Parameters
Path parameters
snapshot_identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads 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.
Request Body
fields
array
application/json
{ "fields": [ "name", "identifier" ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/{snapshot_identifier}/chunks/{chunk_identifier}/download

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.

Parameters
Path parameters
snapshot_identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads 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.
Header parameters
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 Range to the presigned URL in the redirect instead.
Response
  • 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" }
HEAD https://api.enterprise.wikimedia.com/v2/snapshots/{snapshot_identifier}/chunks/{chunk_identifier}/download

Set of headers that describe the snapshot chunk download.

Parameters
Path parameters
snapshot_identifier
string
Required
Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_14 downloads categories used in de.wikipedia.org, enwiki_namespace_0 downloads articles used in en.wikipedia.org, frwikivoyage_namespace_10 downloads 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.
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata
Parameters
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query 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 filters query 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 returns 422 Unprocessable Entity.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/wikidata
Request Body
fields
array
filters
array
application/json
{ "fields": [ "name", "identifier" ], "filters": [ { "field": "namespace.identifier", "value": 0 } ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}
Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query parameter per field: ?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}
Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Request Body
fields
array
application/json
{ "fields": [ "name", "identifier" ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/download

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.

Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Header parameters
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 Range to the presigned URL in the redirect instead.
Response
  • 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" }
HEAD https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/download

Set of headers that describe the Wikidata Snapshot download.

Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks
Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query 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 filters query 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 returns 422 Unprocessable Entity.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks
Parameters
Path parameters
identifier
string
Required
One of: items properties
Wikidata identifier is either 'items' for all QIDs in the Main Graph, or 'properties' for all PIDs.
Request Body
fields
array
filters
array
application/json
{ "fields": [ "name", "identifier" ], "filters": [ { "field": "identifier", "value": "wikidata_items_chunk_0" } ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks/{chunk_identifier}
Parameters
Path parameters
identifier
string
Required
One of: items properties
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.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query parameter per field: ?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks/{chunk_identifier}
Parameters
Path parameters
identifier
string
Required
One of: items properties
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.
Request Body
fields
array
application/json
{ "fields": [ "name", "identifier" ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks/{chunk_identifier}/download

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.

Parameters
Path parameters
identifier
string
Required
One of: items properties
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.
Header parameters
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 Range to the presigned URL in the redirect instead.
Response
  • 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" }
HEAD https://api.enterprise.wikimedia.com/v2/snapshots/wikidata/{identifier}/chunks/{chunk_identifier}/download

Set of headers that describe the Wikidata snapshot chunk download.

Parameters
Path parameters
identifier
string
Required
One of: items properties
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.
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents
Parameters
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query 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 filters query 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 returns 422 Unprocessable Entity.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents
Request Body
fields
array
filters
array
application/json
{ "fields": [ "name", "identifier" ], "filters": [ { "field": "is_part_of.identifier", "value": "enwiki" } ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents/{identifier}
Parameters
Path parameters
identifier
string
Required
Structured Contents Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_0 downloads structured_contents used in de.wikipedia.org, enwiki_namespace_0 downloads 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, and idwiki_namespace_0.
Query parameters
fields
array
Optional
Select which fields to receive in your response, using JSON dot notation. Sent as one fields query parameter per field: ?fields=name&fields=identifier. A comma-separated list in a single value is not supported.
Response
  • 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" }
POST https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents/{identifier}
Parameters
Path parameters
identifier
string
Required
Structured Contents Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_0 downloads structured_contents used in de.wikipedia.org, enwiki_namespace_0 downloads 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, and idwiki_namespace_0.
Request Body
fields
array
application/json
{ "fields": [ "name", "identifier" ] }
Response
  • 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.

GET https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents/{identifier}/download

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.

Parameters
Path parameters
identifier
string
Required
Structured Contents Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_0 downloads structured_contents used in de.wikipedia.org, enwiki_namespace_0 downloads 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, and idwiki_namespace_0.
Header parameters
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 Range to the presigned URL in the redirect instead.
Response
  • 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" }
HEAD https://api.enterprise.wikimedia.com/v2/snapshots/structured-contents/{identifier}/download

Set of headers that describe the structured contents snapshot download.

Parameters
Path parameters
identifier
string
Required
Structured Contents Snapshot identifier looks like <language><project_name>_namespace_<number>, examples: dewiki_namespace_0 downloads structured_contents used in de.wikipedia.org, enwiki_namespace_0 downloads 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, and idwiki_namespace_0.
Response
  • 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" }