Wikimedia REST API v1

{"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":"/.+/"}}}]}},"/transform/html/to/wikitext":{"post":{"tags":["Transforms"],"summary":"Transform HTML to Wikitext","description":"Transform [Parsoid HTML](https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec)\nto Wikitext.\n\nWhen converting pre-existing (possibly modified) content, you should\npass in the `title`, `revision`, and `If-Match` header. This lets\n[Parsoid](https://www.mediawiki.org/wiki/Parsoid) preserve small\nsyntactic variations in wikitext, which ensures that diffs are\nreadable.\n\n- Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n- Rate limit: 25 req/s\n","parameters":[{"name":"if-match","in":"header","description":"The `ETag` header of the original render indicating it's revision and timeuuid.\nRequired if both `title` and `revision` parameters are present.\n","schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["html"],"properties":{"html":{"type":"string","description":"The HTML to transform","x-textarea":true},"scrub_wikitext":{"type":"boolean","description":"Normalise the DOM to yield cleaner wikitext?"}}}}},"required":true},"responses":{"200":{"description":"MediaWiki Wikitext.","content":{"text/plain; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/wikitext/1.0.0\"":{"schema":{"type":"string"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page title or revision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"409":{"description":"Revision was restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"410":{"description":"Page was deleted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/transform/html/to/wikitext/{title}":{"post":{"tags":["Transforms"],"summary":"Transform HTML to Wikitext","description":"Transform [Parsoid HTML](https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec)\nto Wikitext.\n\nWhen converting pre-existing (possibly modified) content, you should\npass in the `title`, `revision`, and `If-Match` header. This lets\n[Parsoid](https://www.mediawiki.org/wiki/Parsoid) preserve small\nsyntactic variations in wikitext, which ensures that diffs are\nreadable.\n\n- Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n- Rate limit: 25 req/s\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":"if-match","in":"header","description":"The `ETag` header of the original render indicating it's revision and timeuuid.\nRequired if both `title` and `revision` parameters are present.\n","schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["html"],"properties":{"html":{"type":"string","description":"The HTML to transform","x-textarea":true},"scrub_wikitext":{"type":"boolean","description":"Normalise the DOM to yield cleaner wikitext?"}}}}},"required":true},"responses":{"200":{"description":"MediaWiki Wikitext.","content":{"text/plain; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/wikitext/1.0.0\"":{"schema":{"type":"string"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page title or revision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"409":{"description":"Revision was restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"410":{"description":"Page was deleted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/transform/html/to/wikitext/{title}/{revision}":{"post":{"tags":["Transforms"],"summary":"Transform HTML to Wikitext","description":"Transform [Parsoid HTML](https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec)\nto Wikitext.\n\nWhen converting pre-existing (possibly modified) content, you should\npass in the `title`, `revision`, and `If-Match` header. This lets\n[Parsoid](https://www.mediawiki.org/wiki/Parsoid) preserve small\nsyntactic variations in wikitext, which ensures that diffs are\nreadable.\n\n- Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n- Rate limit: 25 req/s\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 page revision","required":true,"schema":{"type":"integer"}},{"name":"if-match","in":"header","description":"The `ETag` header of the original render indicating it's revision and timeuuid.\nRequired if both `title` and `revision` parameters are present.\n","schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["html"],"properties":{"html":{"type":"string","description":"The HTML to transform","x-textarea":true},"scrub_wikitext":{"type":"boolean","description":"Normalise the DOM to yield cleaner wikitext?"}}}}},"required":true},"responses":{"200":{"description":"MediaWiki Wikitext.","content":{"text/plain; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/wikitext/1.0.0\"":{"schema":{"type":"string"}}}},"403":{"description":"Access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page title or revision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"409":{"description":"Revision was restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"410":{"description":"Page was deleted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/transform/wikitext/to/html":{"post":{"tags":["Transforms"],"summary":"Transform Wikitext to HTML","description":"Transform wikitext to HTML. Note that if you set `stash: true`, you\nalso need to supply the title.\n\n- Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n- Rate limit: 25 req/s (5 req/s when `stash: true`)\n","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["wikitext"],"properties":{"wikitext":{"type":"string","description":"The Wikitext to transform to HTML","x-textarea":true},"body_only":{"type":"boolean","description":"Return only `body.innerHTML`"},"stash":{"type":"boolean","description":"Whether to temporarily stash the result of the transformation"}}}}},"required":true},"responses":{"200":{"description":"See wikipage https://www.mediawiki.org/wiki/Parsoid/MediaWiki_DOM_spec","content":{"text/html; charset=utf-8; profile=\"https://www.mediawiki.org/wiki/Specs/HTML/2.1.0\"":{"schema":{"type":"string"}}}},"403":{"description":"access to the specific revision is restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"404":{"description":"Unknown page title or revision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"409":{"description":"Revision was restricted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"410":{"description":"Page was deleted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}},"default":{"description":"Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/problem"}}}}},"x-monitor":false}},"/transform/wikitext/to/html/{title}":{"post":{"tags":["Transforms"],"summary":"Transform Wikitext to HTML","description":"Transform wikitext to HTML. Note that if you set `stash: true`, you\nalso need to supply the title.\n\n- Stability: [stable](https://www.mediawiki.org/wiki/API_versioning#Stable)\n- Rate limit: 25 req/s (5 req/s when `stash: true`)\n","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["wikitext"],"properties":{"wikitext":{"type":"string","description":"The Wikitext to transform to HTML","x-textarea":true},"bod

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