On-Demand API Documentation

Our On-demand REST API returns the current version of any article from all supported Wikimedia projects. Query by article name across all projects or use metadata filtering to request by project and language, with more options to optimize response payloads. On-demand returns JSON by default, but if you would prefer a NDJSON response be sure to include the Accept: application/x-ndjson header in your requests.

The Structured Contents articles endpoint is our sandbox beta endpoint that includes fully parsed Wikipedia Infobox and article sections data in JSON with more features in the roadmap.

Article Lookup

Most current revision of an article.

GET https://api.enterprise.wikimedia.com/v2/articles/{name}

Most current revision of an article.

Parameters

Path parameters

name: string; Required; Article name.

Query parameters

limit: integer; Optional; Limit of articles to return.
fields: array; Optional; Allows to select what fields you receive in your response.
filters: array; Optional; Allows you to filter the response payload.

Response

200 (OK)

application/json
[
  {
    "event": {
      "identifier": "string",
      "type": "string",
      "date_created": "string"
    },
    "additional_entities": "array",
    "article_body": {
      "html": "string",
      "wikitext": "string"
    },
    "has_parts": "array",
    "categories": "array",
    "date_modified": "string",
    "identifier": "integer",
    "in_language": {
      "identifier": "string",
      "name": "string",
      "alternate_name": "string",
      "direction": "string"
    },
    "is_part_of": {
      "identifier": "string",
      "code": "string",
      "name": "string",
      "url": "string",
      "in_language": {
        "identifier": "string",
        "name": "string",
        "alternate_name": "string",
        "direction": "string"
      }
    },
    "license": "array",
    "main_entity": {
      "identifier": "string",
      "url": "string"
    },
    "name": "string",
    "abstract": "string",
    "namespace": {
      "identifier": "number",
      "name": "string",
      "description": "string"
    },
    "protection": "array",
    "redirects": "array",
    "templates": "array",
    "url": "string",
    "version": {
      "comment": "string",
      "editor": {
        "date_started": "string",
        "edit_count": "integer",
        "groups": "array",
        "identifier": "integer",
        "is_anonymous": "boolean",
        "is_bot": "boolean",
        "name": "string"
      },
      "identifier": "integer",
      "is_flagged_stable": "boolean",
      "is_minor_edit": "boolean",
      "noindex": "boolean",
      "scores": {
        "revertrisk": {
          "prediction": "boolean",
          "probability": "object"
        }
      },
      "maintenance_tags": {
        "citation_needed_count": "integer",
        "pov_count": "integer",
        "clarification_needed_count": "integer",
        "update_count": "integer"
      },
      "tags": "array"
    },
    "visibility": {
      "comment": "boolean",
      "text": "boolean",
      "user": "boolean"
    }
  }
]

401 (Unauthorized. The server couldn't verify your credentials. This usually means your user credentials are invalid or missing, or access_token is invalid or expired. Make sure you're sending the correct credentials with your request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
403 (Forbidden. You’ve been authenticated, but your permissions aren’t sufficient to complete this operation.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
404 (Not Found. The server can't locate the resource you're requesting. This could be due to a typo in the endpoint path.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
422 (Unprocessable Entity. The server understood your request, but there's a semantic issue with the data you've provided. This often happens if required fields are missing, or the data format doesn't match what the API expects. Review the request payload for any inconsistencies.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
500 (Internal Server Error. The server encountered an unexpected condition that prevented it from fulfilling the request. Retry request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```

POST https://api.enterprise.wikimedia.com/v2/articles/{name}

Most current revision of an article.

Parameters

Path parameters

name: string; Required; Article name.

Request Body

fields: array
filters: array
limit: integer

Response

200 (OK)

application/json
[
  {
    "event": {
      "identifier": "string",
      "type": "string",
      "date_created": "string"
    },
    "additional_entities": "array",
    "article_body": {
      "html": "string",
      "wikitext": "string"
    },
    "has_parts": "array",
    "categories": "array",
    "date_modified": "string",
    "identifier": "integer",
    "in_language": {
      "identifier": "string",
      "name": "string",
      "alternate_name": "string",
      "direction": "string"
    },
    "is_part_of": {
      "identifier": "string",
      "code": "string",
      "name": "string",
      "url": "string",
      "in_language": {
        "identifier": "string",
        "name": "string",
        "alternate_name": "string",
        "direction": "string"
      }
    },
    "license": "array",
    "main_entity": {
      "identifier": "string",
      "url": "string"
    },
    "name": "string",
    "abstract": "string",
    "namespace": {
      "identifier": "number",
      "name": "string",
      "description": "string"
    },
    "protection": "array",
    "redirects": "array",
    "templates": "array",
    "url": "string",
    "version": {
      "comment": "string",
      "editor": {
        "date_started": "string",
        "edit_count": "integer",
        "groups": "array",
        "identifier": "integer",
        "is_anonymous": "boolean",
        "is_bot": "boolean",
        "name": "string"
      },
      "identifier": "integer",
      "is_flagged_stable": "boolean",
      "is_minor_edit": "boolean",
      "noindex": "boolean",
      "scores": {
        "revertrisk": {
          "prediction": "boolean",
          "probability": "object"
        }
      },
      "maintenance_tags": {
        "citation_needed_count": "integer",
        "pov_count": "integer",
        "clarification_needed_count": "integer",
        "update_count": "integer"
      },
      "tags": "array"
    },
    "visibility": {
      "comment": "boolean",
      "text": "boolean",
      "user": "boolean"
    }
  }
]

401 (Unauthorized. The server couldn't verify your credentials. This usually means your user credentials are invalid or missing, or access_token is invalid or expired. Make sure you're sending the correct credentials with your request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
403 (Forbidden. You’ve been authenticated, but your permissions aren’t sufficient to complete this operation.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
404 (Not Found. The server can't locate the resource you're requesting. This could be due to a typo in the endpoint path.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
422 (Unprocessable Entity. The server understood your request, but there's a semantic issue with the data you've provided. This often happens if required fields are missing, or the data format doesn't match what the API expects. Review the request payload for any inconsistencies.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
500 (Internal Server Error. The server encountered an unexpected condition that prevented it from fulfilling the request. Retry request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```

Article Structured Contents (BETA)

Lookup for the structured representation of the Article.

GET https://api.enterprise.wikimedia.com/v2/structured-contents/{name}

Lookup for the structured representation of the Article.

Parameters

Path parameters

name: string; Required; Article name.

Query parameters

limit: integer; Optional; Limit of articles to return.
fields: array; Optional; Allows to select what fields you receive in your response.
filters: array; Optional; Allows you to filter the response payload.

Response

200 (OK)

application/json
[
  {
    "name": "string",
    "identifier": "integer",
    "abstract": "string",
    "description": "string",
    "url": "string",
    "date_created": "string",
    "date_modified": "string",
    "infobox": "array",
    "sections": "array",
    "main_entity": {
      "identifier": "string",
      "url": "string"
    },
    "additional_entities": "array",
    "image": {
      "content_url": "string",
      "width": "string",
      "height": "string",
      "caption": "string",
      "alternative_text": "string"
    },
    "version": {
      "comment": "string",
      "editor": {
        "date_started": "string",
        "edit_count": "integer",
        "groups": "array",
        "identifier": "integer",
        "is_anonymous": "boolean",
        "is_bot": "boolean",
        "name": "string"
      },
      "identifier": "integer",
      "is_flagged_stable": "boolean",
      "is_minor_edit": "boolean",
      "noindex": "boolean",
      "scores": {
        "revertrisk": {
          "prediction": "boolean",
          "probability": "object"
        }
      },
      "maintenance_tags": {
        "citation_needed_count": "integer",
        "pov_count": "integer",
        "clarification_needed_count": "integer",
        "update_count": "integer"
      },
      "tags": "array"
    },
    "is_part_of": {
      "identifier": "string",
      "code": "string",
      "name": "string",
      "url": "string",
      "in_language": {
        "identifier": "string",
        "name": "string",
        "alternate_name": "string",
        "direction": "string"
      }
    },
    "in_language": {
      "identifier": "string",
      "name": "string",
      "alternate_name": "string",
      "direction": "string"
    },
    "license": {
      "identifier": "string",
      "name": "string",
      "url": "string"
    }
  }
]

401 (Unauthorized. The server couldn't verify your credentials. This usually means your user credentials are invalid or missing, or access_token is invalid or expired. Make sure you're sending the correct credentials with your request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
403 (Forbidden. You’ve been authenticated, but your permissions aren’t sufficient to complete this operation.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
404 (Not Found. The server can't locate the resource you're requesting. This could be due to a typo in the endpoint path.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
422 (Unprocessable Entity. The server understood your request, but there's a semantic issue with the data you've provided. This often happens if required fields are missing, or the data format doesn't match what the API expects. Review the request payload for any inconsistencies.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
500 (Internal Server Error. The server encountered an unexpected condition that prevented it from fulfilling the request. Retry request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```

POST https://api.enterprise.wikimedia.com/v2/structured-contents/{name}

Lookup for the structured representation of the Article.

Parameters

Path parameters

name: string; Required; Article name.

Request Body

fields: array
filters: array
limit: integer

Response

200 (OK)

application/json
[
  {
    "name": "string",
    "identifier": "integer",
    "abstract": "string",
    "description": "string",
    "url": "string",
    "date_created": "string",
    "date_modified": "string",
    "infobox": "array",
    "sections": "array",
    "main_entity": {
      "identifier": "string",
      "url": "string"
    },
    "additional_entities": "array",
    "image": {
      "content_url": "string",
      "width": "string",
      "height": "string",
      "caption": "string",
      "alternative_text": "string"
    },
    "version": {
      "comment": "string",
      "editor": {
        "date_started": "string",
        "edit_count": "integer",
        "groups": "array",
        "identifier": "integer",
        "is_anonymous": "boolean",
        "is_bot": "boolean",
        "name": "string"
      },
      "identifier": "integer",
      "is_flagged_stable": "boolean",
      "is_minor_edit": "boolean",
      "noindex": "boolean",
      "scores": {
        "revertrisk": {
          "prediction": "boolean",
          "probability": "object"
        }
      },
      "maintenance_tags": {
        "citation_needed_count": "integer",
        "pov_count": "integer",
        "clarification_needed_count": "integer",
        "update_count": "integer"
      },
      "tags": "array"
    },
    "is_part_of": {
      "identifier": "string",
      "code": "string",
      "name": "string",
      "url": "string",
      "in_language": {
        "identifier": "string",
        "name": "string",
        "alternate_name": "string",
        "direction": "string"
      }
    },
    "in_language": {
      "identifier": "string",
      "name": "string",
      "alternate_name": "string",
      "direction": "string"
    },
    "license": {
      "identifier": "string",
      "name": "string",
      "url": "string"
    }
  }
]

401 (Unauthorized. The server couldn't verify your credentials. This usually means your user credentials are invalid or missing, or access_token is invalid or expired. Make sure you're sending the correct credentials with your request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
403 (Forbidden. You’ve been authenticated, but your permissions aren’t sufficient to complete this operation.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
404 (Not Found. The server can't locate the resource you're requesting. This could be due to a typo in the endpoint path.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
422 (Unprocessable Entity. The server understood your request, but there's a semantic issue with the data you've provided. This often happens if required fields are missing, or the data format doesn't match what the API expects. Review the request payload for any inconsistencies.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```
500 (Internal Server Error. The server encountered an unexpected condition that prevented it from fulfilling the request. Retry request.)
```
application/json
{
  "message": "string",
  "status": "integer"
}
```