Wikimedia REST API (RESTBase)

{"openapi":"3.0.1","info":{"version":"1.0.0","title":"Wikimedia REST API","description":"This API provides cacheable and straightforward access to Wikimedia content and data, in machine-readable formats.\n### Global Rules\n- Limit your clients to no more than 200 requests/s to this API.\n  Each API endpoint's documentation may detail more specific usage limits.\n- Set a unique `User-Agent` or `Api-User-Agent` header that\n  allows us to contact you quickly. Email addresses or URLs\n  of contact pages work well.\n\nBy using this API, you agree to Wikimedia's [Terms of Use](https://wikimediafoundation.org/wiki/Terms_of_Use) and [Privacy Policy](https://wikimediafoundation.org/wiki/Privacy_policy). Unless otherwise specified in the endpoint documentation below, content accessed via this API is licensed under the [CC-BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/) and [GFDL](https://www.gnu.org/copyleft/fdl.html) licenses, and you irrevocably agree to release modifications or additions made through this API under these licenses. Check the [Wikimedia REST API documentation](https://www.mediawiki.org/wiki/Wikimedia_REST_API) for background and details.\n### Endpoint documentation\nPlease consult each endpoint's documentation for details on:\n- Licensing information for the specific type of content\n  and data served via the endpoint.\n- Stability markers to inform you about development status and\n  change policy, according to\n  [our API version policy](https://www.mediawiki.org/wiki/API_versioning).\n- Endpoint specific usage limits.\n","termsOfService":"https://wikimediafoundation.org/wiki/Terms_of_Use","contact":{"name":"the Wikimedia Services team","url":"http://mediawiki.org/wiki/Wikimedia_REST_API"},"license":{"name":"Apache2","url":"http://www.apache.org/licenses/LICENSE-2.0"}},"x-host-basePath":"/api/rest_v1","paths":{"/page/":{"get":{"tags":["Page content"],"summary":"List page-related API entry points.","description":"Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n","responses":{"200":{"description":"A list of page-related API end points.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listing"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/page/title/{title}":{"get":{"tags":["Page content"],"summary":"Get revision metadata for a title.","description":"Returns the revision metadata for the given title. If a revision ID is provided,\nmetadata for that revision is returned, otherwise the latest revision ID is assumed.\n\nStability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable).\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The latest revision metadata for the provided title.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/revision"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid these redirects, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title or no revisions found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":true,"x-amples":[{"title":"Get rev by title from storage","request":{"params":{"domain":"en.wikipedia.org","title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"application/json"},"body":{"items":[{"title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein","rev":"/\\d+/","tid":"/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/","comment":"/.*/","page_language":"en"}]}}}]}},"/page/title/{title}/{revision}":{"get":{"tags":["Page content"],"summary":"Get revision metadata for a title.","description":"Returns the revision metadata for the given title. If a revision ID is provided,\nmetadata for that revision is returned, otherwise the latest revision ID is assumed.\n\nStability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable).\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","description":"The revision id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The latest revision metadata for the provided title.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/revision"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid these redirects, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title or no revisions found.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false,"x-amples":[{"title":"Get rev by title from storage","request":{"params":{"domain":"en.wikipedia.org","title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"application/json"},"body":{"items":[{"title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein","rev":"/\\d+/","tid":"/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/","comment":"/.*/","page_language":"en"}]}}}]}},"/page/html/{title}":{"get":{"tags":["Page content"],"summary":"Get latest HTML for a title.","description":"Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"redirect","in":"query","description":"Requests for [redirect pages](https://www.mediawiki.org/wiki/Help:Redirects) return HTTP 302 with a redirect target in `Location` header and content in the body.\nTo get a 200 response instead, supply `false` to the `redirect` parameter.\n","schema":{"type":"boolean"},"required":false},{"name":"stash","in":"query","description":"Whether to temporary stash data-parsoid metadata in order to support transforming the\nmodified content later. If this parameter is set, requests are rate-limited on\na per-client basis (max 5 requests per second per client)\n","schema":{"type":"boolean"}},{"name":"Accept-Language","in":"header","description":"The desired language variant code for wikis where LanguageConverter is enabled. Example: `sr-el` for Latin transcription of the Serbian language.\n","schema":{"type":"string"}}],"responses":{"200":{"description":"The latest HTML for the given page title.\n\nSee [the MediaWiki DOM\nspec](https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec) for a\ndescription of the MediaWiki-specific semantic markup in this HTML.\nNote that additional metadata is available in the HTML head.\n","headers":{"ETag":{"description":"ETag header indicating the revision and render timeuuid\nseparated by a slash:\n\"701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc\"\nThis ETag can be passed to the HTML save end point (as\n`base_etag` POST parameter), and can also be used to retrieve\nthe exact corresponding data-parsoid metadata, by requesting\nthe specific `revision` and `tid` indicated by the `ETag`.\n","schema":{"type":"string"}}},"content":{"text/html; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/HTML/2.1.0\"":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target, and the body contains the actual page contents as HTML.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":true,"x-amples":[{"title":"Get html by title from storage","request":{"params":{"domain":"en.wikipedia.org","title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"/^text\\/html.+/"},"body":"/^<!DOCTYPE html>.*/"}}]}},"/page/html/{title}/{revision}":{"get":{"tags":["Page content"],"summary":"Get HTML for a specific title/revision & optionally timeuuid.","description":"Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n","operationId":"getFormatRevision","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","description":"The revision","required":true,"schema":{"type":"integer"}},{"name":"redirect","in":"query","description":"Requests for [redirect pages](https://www.mediawiki.org/wiki/Help:Redirects) return HTTP 302 with a redirect target in `Location` header and content in the body.\nTo get a 200 response instead, supply `false` to the `redirect` parameter.\n","schema":{"type":"boolean"}},{"name":"stash","in":"query","description":"Whether to temporary stash data-parsoid metadata in order to support transforming the\nmodified content later. If this parameter is set, requests are rate-limited on\na per-client basis (max 5 requests per second per client)\n","schema":{"type":"boolean"}},{"name":"Accept-Language","in":"header","description":"The desired language variant code for wikis where LanguageConverter is enabled. Example: `sr-el` for Latin transcription of the Serbian language.\n","schema":{"type":"string"}}],"responses":{"200":{"description":"The html for the given page, revision and tid.\n\nSee [the MediaWiki DOM\nspec](https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec) for a\ndescription of the MediaWiki-specific semantic markup in this HTML.\nNote that additional metadata is available in the HTML head.\n\nThis HTML can be edited using arbitrary HTML tools. The modified HTML\ncan be converted back to wikitext using the\n[/transform/html/to/wikitext{/title}{/revision}](#!/Transforms/transform_html_to_wikitext__title___revision__post)\nentry point.\n","headers":{"ETag":{"description":"ETag header indicating the revision and render timeuuid\nseparated by a slash:\n\"701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc\"\nThis ETag can be passed to the HTML save end point (as\n`base_etag` POST parameter), and can also be used to retrieve\nthe exact corresponding data-parsoid metadata, by requesting\nthe specific `revision` and `tid` indicated by the `ETag`.\n","schema":{"type":"string"}}},"content":{"text/html; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/HTML/2.1.0\"":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target, and the body contains the actual page revision contents as HTML.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"400":{"description":"Invalid revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page, revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/page/lint/{title}":{"get":{"tags":["Page content"],"summary":"Get the linter errors for a specific title/revision.","description":"Stability: [experimental](https://www.mediawiki.org/wiki/API_versioning#Experimental)\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The lint errors for the given page and optionally revision.\n\nSee [the Linter extension docs](https://www.mediawiki.org/wiki/Extension:Linter) for more\ndetails.\n","content":{"application/json":{"schema":{"type":"object"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target, and the body contains the actual page revision contents as HTML.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"400":{"description":"Invalid revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page, revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/page/lint/{title}/{revision}":{"get":{"tags":["Page content"],"summary":"Get the linter errors for a specific title/revision.","description":"Stability: [experimental](https://www.mediawiki.org/wiki/API_versioning#Experimental)\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","description":"The revision","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The lint errors for the given page and optionally revision.\n\nSee [the Linter extension docs](https://www.mediawiki.org/wiki/Extension:Linter) for more\ndetails.\n","content":{"application/json":{"schema":{"type":"object"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target, and the body contains the actual page revision contents as HTML.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"400":{"description":"Invalid revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page, revision or tid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/page/summary/{title}":{"get":{"tags":["Page content"],"summary":"Get basic metadata and simplified article introduction.","description":"The summary response includes an extract of the first paragraph of the page in plain text\nand HTML as well as the type of page. This is useful for page previews (fka. Hovercards,\naka. Popups) on the web and link previews in the apps.\n\nStability: [stable](https://www.mediawiki.org/wiki/Wikimedia_Product/Wikimedia_Product_Infrastructure_team/API_endpoint_stability_policy#Stable)\n\nPlease follow [wikitech-l](https://lists.wikimedia.org/mailman/listinfo/wikitech-l) or [mediawiki-api-announce](https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce) for announcements of breaking changes.\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"redirect","in":"query","description":"Requests for [redirect pages](https://www.mediawiki.org/wiki/Help:Redirects) return HTTP 302 with a redirect target in `Location` header and content in the body.\nTo get a 200 response instead, supply `false` to the `redirect` parameter.\n","schema":{"type":"boolean"}},{"name":"Accept-Language","in":"header","description":"The desired language variant code for wikis where LanguageConverter is enabled. Example: `sr-el` for Latin transcription of the Serbian language.\n","schema":{"type":"string"}}],"responses":{"200":{"description":"The summary for the given page","headers":{"ETag":{"description":"Syntax: \"{revision}/{tid}\". Example: \"701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc\"\n","schema":{"type":"string"}}},"content":{"application/json; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/Summary/1.4.2\"":{"schema":{"$ref":"#/components/schemas/summary"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":true,"x-amples":[{"title":"Get summary from storage","request":{"params":{"domain":"en.wikipedia.org","title":"San_Francisco"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"/^application\\/json/"},"body":{"extract":"/.+/","extract_html":"/.+/","thumbnail":{"source":"/^https:/"},"originalimage":{"source":"/^https:/"},"lang":"en","dir":"ltr","description":"/.+/"}}}]}},"/page/media-list/{title}":{"get":{"tags":["Page content"],"summary":"Get list of media files used on a page.","description":"Gets the list of media items (images, audio, and video) in the order in which they appear on a\ngiven wiki page.\n\nStability: [unstable](https://www.mediawiki.org/wiki/Wikimedia_Product/Wikimedia_Product_Infrastructure_team/API_endpoint_stability_policy#Unstable)\n\nPlease follow [wikitech-l](https://lists.wikimedia.org/mailman/listinfo/wikitech-l) or [mediawiki-api-announce](https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce) for announcements of breaking changes.\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"redirect","in":"query","description":"Requests for [redirect pages](https://www.mediawiki.org/wiki/Help:Redirects) return HTTP 302 with a redirect target in `Location` header and content in the body.\nTo get a 200 response instead, supply `false` to the `redirect` parameter.\n","schema":{"type":"boolean"}}],"responses":{"200":{"description":"JSON containing metadata of media items appearing on the given page.","headers":{"ETag":{"description":"Syntax: \"{revision}/{tid}\". Example: \"701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc\"\n","schema":{"type":"string"}}},"content":{"application/json; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/Media/1.3.1\"":{"schema":{"$ref":"#/components/schemas/media_list"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"operationId":"getContent-media-list","x-monitor":true,"x-amples":[{"title":"Get media-list from storage","request":{"params":{"domain":"en.wikipedia.org","title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"/^application\\/json/"},"body":{"revision":"/\\d+/","tid":"/.+/","items":[{"type":"/.+/","section_id":"/\\d+/","showInGallery":"/.+/"}]}}}]}},"/page/media-list/{title}/{revision}":{"get":{"tags":["Page content"],"summary":"Get list of media files used on a page.","description":"Gets the list of media items (images, audio, and video) in the order in which they appear on a\ngiven wiki page.\n\nStability: [unstable](https://www.mediawiki.org/wiki/Wikimedia_Product/Wikimedia_Product_Infrastructure_team/API_endpoint_stability_policy#Unstable)\n\nPlease follow [wikitech-l](https://lists.wikimedia.org/mailman/listinfo/wikitech-l) or [mediawiki-api-announce](https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce) for announcements of breaking changes.\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","description":"Optional page revision. Note that older revisions are not stored, so request latency with the revision would be higher.\n","required":true,"schema":{"type":"integer"}},{"name":"redirect","in":"query","description":"Requests for [redirect pages](https://www.mediawiki.org/wiki/Help:Redirects) return HTTP 302 with a redirect target in `Location` header and content in the body.\nTo get a 200 response instead, supply `false` to the `redirect` parameter.\n","schema":{"type":"boolean"}}],"responses":{"200":{"description":"JSON containing metadata of media items appearing on the given page.","headers":{"ETag":{"description":"Syntax: \"{revision}/{tid}\". Example: \"701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc\"\n","schema":{"type":"string"}}},"content":{"application/json; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/Media/1.3.1\"":{"schema":{"$ref":"#/components/schemas/media_list"}}}},"301":{"description":"A permanent redirect is returned if the supplied article title was not in the normalized form.\nTo avoid this kind of redirect, you can use the [mediawiki-title](https://github.com/wikimedia/mediawiki-title) library to perform\ntitle normalization client-side.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"302":{"description":"The page is a [redirect page](https://www.mediawiki.org/wiki/Help:Redirects).\nThe `location` header points to the redirect target.\nIf you would like to avoid automatically following redirect pages, set the `redirect=false` query parameter.\n\nBeware that redirected pre-flighted cross-origin requests (such as those sending custom request headers like `Api-User-Agent`)\nwill fail in most current browsers [due to a spec bug](https://github.com/whatwg/fetch/issues/204).\n"},"404":{"description":"Unknown page title","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"operationId":"getContentWithRevision-media-list","x-monitor":false,"x-amples":[{"title":"Get media-list from storage","request":{"params":{"domain":"en.wikipedia.org","title":"User:BSitzmann_(WMF)/MCS/Test/Frankenstein"}},"response":{"status":200,"headers":{"etag":"/.+/","content-type":"/^application\\/json/"},"body":{"revision":"/\\d+/","tid":"/.+/","items":[{"type":"/.+/","section_id":"/\\d+/","showInGallery":"/.+/"}]}}}]}},"/page/mobile-html/{title}":{"get":{"tags":["Page content"],"summary":"Get page content HTML optimized for mobile consumption.","description":"Gets the content HTML optimized for mobile consumption for the given page. This content\nis derived from Parsoid HTML (see `/page/html/{title}` endpoint).\nThe difference to Parsoid HTML is roughly:\n* Some elements and attributes not needed for the reading case are removed.\n* LeadIntroductionTransform: The introductory paragraph is moved before an infobox.\n* RedLinks: Red links are flattened (=turned into span elements).\n* WidenImage: images that should be displayed in gallery are widened.\n* Section headings are slightly changed by wrapping the headings inside a div and adding\n  a span element inside the new div for the edit buttons.\n* Additional classes are added to img elements to fix issues with non-white backgrounds.\n  See Theme support below for instructions on how to enable that.\n* Pagelib CSS files needed to display the content are referenced.\n* LazyLoadTransform: server-side portion/prep for lazy loading of images.\n* CollapseTable: server-side portion/prep for collapsing tables.\n\nWhat's not included? What parts of the PageLibrary does a client still have to do?\n* Theme support: Themes can be turned on by adding a theme class to the root <html> tag.\n  Possible class names are:\n  * `pagelib_theme_default`\n  * `pagelib_theme_dark`\n  * `pagelib_theme_black`\n  * `pagelib_theme_sepia`\n\n  The pagelib JS has functionality to do that: ThemeTransform.setTheme(document, theme).\n* Dim images: DimImagesTransform.dim(window, enable)\n* PlatformTransform.classify(window) to trigger Android and iOS app specific CSS rules\n* LazyLoadTransformer: client side companion of LazyLoadTransform (note the extra *er*\nhere)\n* FooterTransformer: seems to be more UI than content, requires I18N, too\n\nStability: [experimental](https://www.mediawiki.org/wiki/API_versioning#Experimental)\n","parameters":[{"name":"title","in":"path","description":"Page title. Use underscores instead of spaces. Use percent-encoding. Example: `Main_Page`.","required":true,"schema":{"typ

# --- truncated at 32 KB (103 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/wikimedia/refs/heads/main/openapi/wikimedia-rest-api.json