MediaWiki API help

Which action to perform.

block

Block a user.

changeauthenticationdata

Change authentication data for the current user.

checktoken

Check the validity of a token from action=query&meta=tokens.

clearhasmsg

Clears the hasmsg flag for the current user.

clientlogin

Log in to the wiki using the interactive flow.

compare

Get the difference between two pages.

createaccount

Create a new user account.

cspreport

Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.

delete

Delete a page.

edit

Create and edit pages.

emailuser

Email a user.

expandtemplates

Expands all templates within wikitext.

feedcontributions

Returns a user contributions feed.

feedrecentchanges

Returns a recent changes feed.

feedwatchlist

Returns a watchlist feed.

filerevert

Revert a file to an old version.

help

Display help for the specified modules.

imagerotate

Rotate one or more images.

import

Import a page from another wiki, or from an XML file.

linkaccount

Link an account from a third-party provider to the current user.

login

Log in and get authentication cookies.

logout

Log out and clear session data.

managetags

Perform management tasks relating to change tags.

mergehistory

Merge page histories.

move

Move a page.

opensearch

Search the wiki using the OpenSearch protocol.

options

Change preferences of the current user.

paraminfo

Obtain information about API modules.

parse

Parses content and returns parser output.

patrol

Patrol a page or revision.

protect

Change the protection level of a page.

purge

Purge the cache for the given titles.

query

Fetch data from and about MediaWiki.

removeauthenticationdata

Remove authentication data for the current user.

resetpassword

Send a password reset email to a user.

revisiondelete

Delete and undelete revisions.

rollback

Undo the last edit to the page.

rsd

Export an RSD (Really Simple Discovery) schema.

setnotificationtimestamp

Update the notification timestamp for watched pages.

setpagelanguage

Change the language of a page.

stashedit

Prepare an edit in shared cache.

tag

Add or remove change tags from individual revisions or log entries.

unblock

Unblock a user.

undelete

Restore revisions of a deleted page.

unlinkaccount

Remove a linked third-party account from the current user.

upload

Upload a file, or get the status of pending uploads.

userrights

Change a user's group membership.

validatepassword

Validate a password against the wiki's password policies.

watch

Add or remove pages from the current user's watchlist.

tokens

Deprecated. Get tokens for data-modifying actions.

The format of the output.

json

Output data in JSON format.

jsonfm

Output data in JSON format (pretty-print in HTML).

none

Output nothing.

php

Output data in serialized PHP format.

phpfm

Output data in serialized PHP format (pretty-print in HTML).

rawfm

Output data, including debugging elements, in JSON format (pretty-print in HTML).

xml

Output data in XML format.

xmlfm

Output data in XML format (pretty-print in HTML).

Maximum lag can be used when MediaWiki is installed on a database replicated cluster. To save actions causing any more site replication lag, this parameter can make the client wait until the replication lag is less than the specified value. In case of excessive lag, error code maxlag is returned with a message like Waiting for $host: $lag seconds lagged.
See Manual: Maxlag parameter for more information.

Set the s-maxage HTTP cache control header to this many seconds. Errors are never cached.

Set the max-age HTTP cache control header to this many seconds. Errors are never cached.

Verify the user is logged in if set to user, or has the bot user right if bot.

Verify the current user is the named user.

Any value given here will be included in the response. May be used to distinguish requests.

Include the hostname that served the request in the results.

Include the current timestamp in the result.

Include the languages used for uselang and errorlang in the result.

When accessing the API using a cross-domain AJAX request (CORS), set this to the originating domain. This must be included in any pre-flight request, and therefore must be part of the request URI (not the POST body).

For authenticated requests, this must match one of the origins in the Origin header exactly, so it has to be set to something like https://en.wikipedia.org or https://meta.wikimedia.org. If this parameter does not match the Origin header, a 403 response will be returned. If this parameter matches the Origin header and the origin is whitelisted, the Access-Control-Allow-Origin and Access-Control-Allow-Credentials headers will be set.

For non-authenticated requests, specify the value *. This will cause the Access-Control-Allow-Origin header to be set, but Access-Control-Allow-Credentials will be false and all user-specific data will be restricted.

Language to use for message translations. action=query&meta=siteinfo with siprop=languages returns a list of language codes, or specify user to use the current user's language preference, or specify content to use this wiki's content language.

Format to use for warning and error text output.

plaintext

Wikitext with HTML tags removed and entities replaced.

wikitext

Unparsed wikitext.

html

HTML.

raw

Message key and parameters.

none

No text output, only the error codes.

bc

Format used prior to MediaWiki 1.29. errorlang and errorsuselocal are ignored.

Language to use for warnings and errors. action=query&meta=siteinfo with siprop=languages returns a list of language codes, or specify content to use this wiki's content language, or specify uselang to use the same value as the uselang parameter.

If given, error texts will use locally-customized messages from the MediaWiki namespace.

Username, IP address, or IP address range to block. Cannot be used together with userid

User ID to block. Cannot be used together with user.

Expiry time. May be relative (e.g. 5 months or 2 weeks) or absolute (e.g. 2014-09-18T12:34:56Z). If set to infinite, indefinite, or never, the block will never expire.

Reason for block.

Block anonymous users only (i.e. disable anonymous edits for this IP address).

Prevent account creation.

Automatically block the last used IP address, and any subsequent IP addresses they try to login from.

Prevent user from sending email through the wiki. (Requires the blockemail right).

Hide the username from the block log. (Requires the hideuser right).

Allow the user to edit their own talk page (depends on $wgBlockAllowsUTEdit).

If the user is already blocked, overwrite the existing block.

Watch the user's or IP address's user and talk pages.

Change tags to apply to the entry in the block log.

A "csrf" token retrieved from action=query&meta=tokens

Use this authentication request, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=change.

A "csrf" token retrieved from action=query&meta=tokens

Type of token being tested.

Token to test.

Maximum allowed age of the token, in seconds.

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=login or from a previous response from this module.

Format to use for returning messages.

Merge field information for all authentication requests into one array.

Preserve state from a previous failed login attempt, if possible.

Return URL for third-party authentication flows, must be absolute. Either this or logincontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a logincontinue request to this API module.

This request is a continuation after an earlier UI or REDIRECT response. Either this or loginreturnurl is required.

A "login" token retrieved from action=query&meta=tokens

First title to compare.

First page ID to compare.

First revision to compare.

Override content of the revision specified by fromtitle, fromid or fromrev.

This parameter specifies the slots that are to be modified. Use fromtext-{slot}, fromcontentmodel-{slot}, and fromcontentformat-{slot} to specify content for each slot.

Text of the specified slot. If omitted, the slot is removed from the revision.

When fromtext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by fromtitle, fromid or fromrev as if for a section edit.

Content serialization format of fromtext-{slot}.

Content model of fromtext-{slot}. If not supplied, it will be guessed based on the other parameters.

Do a pre-save transform on fromtext-{slot}.

Specify fromslots=main and use fromtext-main instead.

Specify fromslots=main and use fromcontentformat-main instead.

Specify fromslots=main and use fromcontentmodel-main instead.

Only use the specified section of the specified 'from' content.

Second title to compare.

Second page ID to compare.

Second revision to compare.

Use a revision relative to the revision determined from fromtitle, fromid or fromrev. All of the other 'to' options will be ignored.

Override content of the revision specified by totitle, toid or torev.

This parameter specifies the slots that are to be modified. Use totext-{slot}, tocontentmodel-{slot}, and tocontentformat-{slot} to specify content for each slot.

Text of the specified slot. If omitted, the slot is removed from the revision.

When totext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by totitle, toid or torev as if for a section edit.

Content serialization format of totext-{slot}.

Content model of totext-{slot}. If not supplied, it will be guessed based on the other parameters.

Do a pre-save transform on totext.

Specify toslots=main and use totext-main instead.

Specify toslots=main and use tocontentformat-main instead.

Specify toslots=main and use tocontentmodel-main instead.

Only use the specified section of the specified 'to' content.

Which pieces of information to get.

diff

The diff HTML.

diffsize

The size of the diff HTML, in bytes.

rel

The revision IDs of the revision previous to 'from' and after 'to', if any.

ids

The page and revision IDs of the 'from' and 'to' revisions.

title

The page titles of the 'from' and 'to' revisions.

user

The user name and ID of the 'from' and 'to' revisions.

comment

The comment on the 'from' and 'to' revisions.

parsedcomment

The parsed comment on the 'from' and 'to' revisions.

size

The size of the 'from' and 'to' revisions.

Return individual diffs for these slots, rather than one combined diff for all slots.

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=create or from a previous response from this module.

Format to use for returning messages.

Merge field information for all authentication requests into one array.

Preserve state from a previous failed login attempt, if possible.

If action=query&meta=authmanagerinfo returned true for hasprimarypreservedstate, requests marked as primary-required should be omitted. If it returned a non-empty value for preservedusername, that username must be used for the username parameter.

Return URL for third-party authentication flows, must be absolute. Either this or createcontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a createcontinue request to this API module.

This request is a continuation after an earlier UI or REDIRECT response. Either this or createreturnurl is required.

A "createaccount" token retrieved from action=query&meta=tokens

Mark as being a report from a monitoring policy, not an enforced policy

What generated the CSP header that triggered this report

Title of the page to delete. Cannot be used together with pageid.

Page ID of the page to delete. Cannot be used together with title.

Reason for the deletion. If not set, an automatically generated reason will be used.

Change tags to apply to the entry in the deletion log.

Add the page to the current user's watchlist.

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

Remove the page from the current user's watchlist.

The name of the old image to delete as provided by action=query&prop=imageinfo&iiprop=archivename.

A "csrf" token retrieved from action=query&meta=tokens

Title of the page to edit. Cannot be used together with pageid.

Page ID of the page to edit. Cannot be used together with title.

Section number. 0 for the top section, new for a new section.

The title for a new section.

Page content.

Edit summary. Also section title when section=new and sectiontitle is not set.

Change tags to apply to the revision.

Mark this edit as a minor edit.

Do not mark this edit as a minor edit even if the "Mark all edits minor by default" user preference is set.

Mark this edit as a bot edit.

Timestamp of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions&rvprop=timestamp.

Timestamp when the editing process began, used to detect edit conflicts. An appropriate value may be obtained using curtimestamp when beginning the edit process (e.g. when loading the page content to edit).

Override any errors about the page having been deleted in the meantime.

Don't edit the page if it exists already.

Throw an error if the page doesn't exist.

Add the page to the current user's watchlist.

Remove the page from the current user's watchlist.

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

The MD5 hash of the text parameter, or the prependtext and appendtext parameters concatenated. If set, the edit won't be done unless the hash is correct.

Add this text to the beginning of the page. Overrides text.

Add this text to the end of the page. Overrides text.

Use section=new to append a new section, rather than this parameter.

Undo this revision. Overrides text, prependtext and appendtext.

Undo all revisions from undo to this one. If not set, just undo one revision.

Automatically resolve redirects.

Content serialization format used for the input text.

Content model of the new content.

A "csrf" token retrieved from action=query&meta=tokens

The token should always be sent as the last parameter, or at least after the text parameter.

User to send email to.

Subject header.

Mail body.

Send a copy of this mail to me.

A "csrf" token retrieved from action=query&meta=tokens

Title of page.

Wikitext to convert.

Revision ID, for {{REVISIONID}} and similar variables.

Which pieces of information to get.

Note that if no values are selected, the result will contain the wikitext, but the output will be in a deprecated format.

wikitext

The expanded wikitext.

categories

Any categories present in the input that are not represented in the wikitext output.

properties

Page properties defined by expanded magic words in the wikitext.

volatile

Whether the output is volatile and should not be reused elsewhere within the page.

ttl

The maximum time after which caches of the result should be invalidated.

modules

Any ResourceLoader modules that parser functions have requested be added to the output. Either jsconfigvars or encodedjsconfigvars must be requested jointly with modules.

jsconfigvars

Gives the JavaScript configuration variables specific to the page.

encodedjsconfigvars

Gives the JavaScript configuration variables specific to the page as a JSON string.

parsetree

The XML parse tree of the input.

Whether to include HTML comments in the output.

Generate XML parse tree (replaced by prop=parsetree).

The format of the feed.

What users to get the contributions for.

Which namespace to filter the contributions by.

From year (and earlier).

From month (and earlier).

Filter contributions that have these tags.

Show only deleted contributions.

Only show edits that are the latest revisions.

Only show edits that are page creations.

Hide minor edits.

Show the size difference between revisions.

The format of the feed.

Namespace to limit the results to.

All namespaces but the selected one.

Include associated (talk or main) namespace.

Days to limit the results to.

Maximum number of results to return.

Show changes since then.

Hide minor changes.

Hide changes made by bots.

Hide changes made by anonymous users.

Hide changes made by registered users.

Hide patrolled changes.

Hide changes made by the current user.

Hide category membership changes.

Filter by tag.

Show only changes on pages linked from this page.

Show changes on pages linked to the selected page instead.

The format of the feed.

List pages modified within this many hours from now.

Link directly to changed sections if possible.

Include multiple revisions of the same page within given timeframe.

Used along with token to access a different user's watchlist.

A security token (available in the user's preferences) to allow access to another user's watchlist.

Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.

Which types of changes to show:

edit

Regular page edits.

new

Page creations.

log

Log entries.

external

External changes.

categorize

Category membership changes.

Don't list changes by this user.

Target filename, without the File: prefix.

Upload comment.

Archive name of the revision to revert to.

A "csrf" token retrieved from action=query&meta=tokens

Modules to display help for (values of the action and format parameters, or main). Can specify submodules with a +.

Include help for submodules of the named module.

Include help for submodules recursively.

Wrap the output in a standard API response structure.

Include a table of contents in the HTML output.

Degrees to rotate image clockwise.

When more results are available, use this to continue.

Tags to apply to the entry in the upload log.

A list of titles to work on.

A list of page IDs to work on.

A list of revision IDs to work on.

Get the list of pages to work on by executing the specified query module.

Note: Generator parameter names must be prefixed with a "g", see examples.

allcategories

Enumerate all categories.

alldeletedrevisions

List all deleted revisions by a user or in a namespace.

allfileusages

List all file usages, including non-existing.

allimages

Enumerate all images sequentially.

alllinks

Enumerate all links that point to a given namespace.

allpages

Enumerate all pages sequentially in a given namespace.

allredirects

List all redirects to a namespace.

allrevisions

List all revisions.

alltransclusions

List all transclusions (pages embedded using {{x}}), including non-existing.

backlinks

Find all pages that link to the given page.

categories

List all categories the pages belong to.

categorymembers

List all pages in a given category.

deletedrevisions

Get deleted revision information.

duplicatefiles

List all files that are duplicates of the given files based on hash values.

embeddedin

Find all pages that embed (transclude) the given title.

exturlusage

Enumerate pages that contain a given URL.

fileusage

Find all pages that use the given files.

images

Returns all files contained on the given pages.

imageusage

Find all pages that use the given image title.

iwbacklinks

Find all pages that link to the given interwiki link.

langbacklinks

Find all pages that link to the given language link.

links

Returns all links from the given pages.

linkshere

Find all pages that link to the given pages.

pageswithprop

List all pages using a given page property.

prefixsearch

Perform a prefix search for page titles.

protectedtitles

List all titles protected from creation.

querypage

Get a list provided by a QueryPage-based special page.

random

Get a set of random pages.

recentchanges

Enumerate recent changes.

redirects

Returns all redirects to the given pages.

revisions

Get revision information.

search

Perform a full text search.

templates

Returns all pages transcluded on the given pages.

transcludedin

Find all pages that transclude the given pages.

watchlist

Get recent changes to pages in the current user's watchlist.

watchlistraw

Get all pages on the current user's watchlist.

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include en, crh, gan, iu, kk, ku, shi, sr, tg, uz and zh.

A "csrf" token retrieved from action=query&meta=tokens

Log entry import summary.

Uploaded XML file.

For uploaded imports: interwiki prefix to apply to unknown user names (and known users if assignknownusers is set).

For interwiki imports: wiki to import from.

For interwiki imports: page to import.

For interwiki imports: import the full history, not just the current version.

For interwiki imports: import all included templates as well.

Import to this namespace. Cannot be used together with rootpage.

Assign edits to local users where the named user exists locally.

Import as subpage of this page. Cannot be used together with namespace.

Change tags to apply to the entry in the import log and to the null revision on the imported pages.

A "csrf" token retrieved from action=query&meta=tokens

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=link or from a previous response from this module.

Format to use for returning messages.

Merge field information for all authentication requests into one array.

Return URL for third-party authentication flows, must be absolute. Either this or linkcontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a linkcontinue request to this API module.

This request is a continuation after an earlier UI or REDIRECT response. Either this or linkreturnurl is required.

A "csrf" token retrieved from action=query&meta=tokens

User name.

Password.

Domain (optional).

A "login" token retrieved from action=query&meta=tokens

A "csrf" token retrieved from action=query&meta=tokens

Which operation to perform:

create

Create a new change tag for manual use.

delete

Remove a change tag from the database, including removing the tag from all revisions, recent change entries and log entries on which it is used.

activate

Activate a change tag, allowing users to apply it manually.

deactivate

Deactivate a change tag, preventing users from applying it manually.

Tag to create, delete, activate or deactivate. For tag creation, the tag must not exist. For tag deletion, the tag must exist. For tag activation, the tag must exist and not be in use by an extension. For tag deactivation, the tag must be currently active and manually defined.

An optional reason for creating, deleting, activating or deactivating the tag.

Whether to ignore any warnings that are issued during the operation.

Change tags to apply to the entry in the tag management log.

A "csrf" token retrieved from action=query&meta=tokens

Title of the page from which history will be merged. Cannot be used together with fromid.

Page ID of the page from which history will be merged. Cannot be used together with from.

Title of the page to which history will be merged. Cannot be used together with toid.

Page ID of the page to which history will be merged. Cannot be used together with to.

Timestamp up to which revisions will be moved from the source page's history to the destination page's history. If omitted, the entire page history of the source page will be merged into the destination page.

Reason for the history merge.

A "csrf" token retrieved from action=query&meta=tokens

Title of the page to rename. Cannot be used together with fromid.

Page ID of the page to rename. Cannot be used together with from.

Title to rename the page to.

Reason for the rename.

Rename the talk page, if it exists.

Rename subpages, if applicable.

Don't create a redirect.

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

Ignore any warnings.

Change tags to apply to the entry in the move log and to the null revision on the destination page.

A "csrf" token retrieved from action=query&meta=tokens

Search string.

Namespaces to search. Ignored if search begins with a valid namespace prefix.

Maximum number of results to return.

Do nothing if $wgEnableOpenSearchSuggest is false.

How to handle redirects:

return

Return the redirect itself.

resolve

Return the target page. May return fewer than limit results.

For historical reasons, the default is "return" for format=json and "resolve" for other formats.

The format of the output.

If warnings are raised with format=json, return an API error instead of ignoring them.

Resets preferences to the site defaults.

List of types of options to reset when the reset option is set.

List of changes, formatted name=value (e.g. skin=vector). If no value is given (not even an equals sign), e.g., optionname|otheroption|..., the option will be reset to its default value. If any value passed contains the pipe character (|), use the alternative multiple-value separator for correct operation.

The name of the option that should be set to the value given by optionvalue.

The value for the option specified by optionname.

A "csrf" token retrieved from action=query&meta=tokens

List of module names (values of the action and format parameters, or main). Can specify submodules with a +, or all submodules with +*, or all submodules recursively with +**.

Format of help strings.

List of query module names (value of prop, meta or list parameter). Use modules=query+foo instead of querymodules=foo.

Get information about the main (top-level) module as well. Use modules=main instead.

Get information about the pageset module (providing titles= and friends) as well.

List of format module names (value of format parameter). Use modules instead.

Title of page the text belongs to. If omitted, contentmodel must be specified, and API will be used as the title.

Text to parse. Use title or contentmodel to control the content model.

Revision ID, for {{REVISIONID}} and similar variables.

Summary to parse.

Parse the content of this page. Cannot be used together with text and title.

Parse the content of this page. Overrides page.

If page or pageid is set to a redirect, resolve it.

Parse the content of this revision. Overrides page and pageid.

Which pieces of information to get:

text

Gives the parsed text of the wikitext.

langlinks

Gives the language links in the parsed wikitext.

categories

Gives the categories in the parsed wikitext.

categorieshtml

Gives the HTML version of the categories.

links

Gives the internal links in the parsed wikitext.

templates

Gives the templates in the parsed wikitext.

images

Gives the images in the parsed wikitext.

externallinks

Gives the external links in the parsed wikitext.

sections

Gives the sections in the parsed wikitext.

revid

Adds the revision ID of the parsed page.

displaytitle

Adds the title of the parsed wikitext.

headhtml

Gives parsed doctype, opening <html>, <head> element and opening <body> of the page.

modules

Gives the ResourceLoader modules used on the page. To load, use mw.loader.using(). Either jsconfigvars or encodedjsconfigvars must be requested jointly with modules.

jsconfigvars

Gives the JavaScript configuration variables specific to the page. To apply, use mw.config.set().

encodedjsconfigvars

Gives the JavaScript configuration variables specific to the page as a JSON string.

indicators

Gives the HTML of page status indicators used on the page.

iwlinks

Gives interwiki links in the parsed wikitext.

wikitext

Gives the original wikitext that was parsed.

properties

Gives various properties defined in the parsed wikitext.

limitreportdata

Gives the limit report in a structured way. Gives no data, when disablelimitreport is set.

limitreporthtml

Gives the HTML version of the limit report. Gives no data, when disablelimitreport is set.

parsetree

The XML parse tree of revision content (requires content model wikitext)

parsewarnings

Gives the warnings that occurred while parsing content.

headitems

Deprecated. Gives items to put in the <head> of the page.

CSS class to use to wrap the parser output.

Do a pre-save transform on the input before parsing it. Only valid when used with text.

Do a pre-save transform (PST) on the input, but don't parse it. Returns the same wikitext, after a PST has been applied. Only valid when used with text.

Includes language links supplied by extensions (for use with prop=langlinks).

Only parse the content of this section number.

When new, parse text and sectiontitle as if adding a new section to the page.

new is allowed only when specifying text.

New section title when section is new.

Unlike page editing, this does not fall back to summary when omitted or empty.

Use disablelimitreport instead.

Omit the limit report ("NewPP limit report") from the parser output.

Omit edit section links from the parser output.

Do not run HTML cleanup (e.g. tidy) on the parser output.

Do not deduplicate inline stylesheets in the parser output.

Generate XML parse tree (requires content model wikitext; replaced by prop=parsetree).

Parse in preview mode.

Parse in section preview mode (enables preview mode too).

Omit table of contents in output.

Apply the selected skin to the parser output. May affect the following properties: langlinks, headitems, modules, jsconfigvars, indicators.

Content serialization format used for the input text. Only valid when used with text.

Content model of the input text. If omitted, title must be specified, and default will be the model of the specified title. Only valid when used with text.

Recentchanges ID to patrol.

Revision ID to patrol.

Change tags to apply to the entry in the patrol log.

A "patrol" token retrieved from action=query&meta=tokens

Title of the page to (un)protect. Cannot be used together with pageid.

ID of the page to (un)protect. Cannot be used together with title.

List of protection levels, formatted action=level (e.g. edit=sysop). A level of all means everyone is allowed to take the action, i.e. no restriction.

Note: Any actions not listed will have restrictions removed.

Expiry timestamps. If only one timestamp is set, it'll be used for all protections. Use infinite, indefinite, infinity, or never, for a never-expiring protection.

Reason for (un)protecting.

Change tags to apply to the entry in the protection log.

Enable cascading protection (i.e. protect transcluded templates and images used in this page). Ignored if none of the given protection levels support cascading.

If set, add the page being (un)protected to the current user's watchlist.

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

A "csrf" token retrieved from action=query&meta=tokens

Update the links tables.

Update the links table, and update the links tables for any page that uses this page as a template.

When more results are available, use this to continue.

A list of titles to work on.

A list of page IDs to work on.

A list of revision IDs to work on.

Get the list of pages to work on by executing the specified query module.

Note: Generator parameter names must be prefixed with a "g", see examples.

allcategories

Enumerate all categories.

alldeletedrevisions

List all deleted revisions by a user or in a namespace.

allfileusages

List all file usages, including non-existing.

allimages

Enumerate all images sequentially.

alllinks

Enumerate all links that point to a given namespace.

allpages

Enumerate all pages sequentially in a given namespace.

allredirects

List all redirects to a namespace.

allrevisions

List all revisions.

alltransclusions

List all transclusions (pages embedded using {{x}}), including non-existing.

backlinks

Find all pages that link to the given page.

categories

List all categories the pages belong to.

categorymembers

List all pages in a given category.

deletedrevisions

Get deleted revision information.

duplicatefiles

List all files that are duplicates of the given files based on hash values.

embeddedin

Find all pages that embed (transclude) the given title.

exturlusage

Enumerate pages that contain a given URL.

fileusage

Find all pages that use the given files.

images

Returns all files contained on the given pages.

imageusage

Find all pages that use the given image title.

iwbacklinks

Find all pages that link to the given interwiki link.

langbacklinks

Find all pages that link to the given language link.

links

Returns all links from the given pages.

linkshere

Find all pages that link to the given pages.

pageswithprop

List all pages using a given page property.

prefixsearch

Perform a prefix search for page titles.

protectedtitles

List all titles protected from creation.

querypage

Get a list provided by a QueryPage-based special page.

random

Get a set of random pages.

recentchanges

Enumerate recent changes.

redirects

Returns all redirects to the given pages.

revisions

Get revision information.

search

Perform a full text search.

templates

Returns all pages transcluded on the given pages.

transcludedin

Find all pages that transclude the given pages.

watchlist

Get recent changes to pages in the current user's watchlist.

watchlistraw

Get all pages on the current user's watchlist.

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include en, crh, gan, iu, kk, ku, shi, sr, tg, uz and zh.

Which properties to get for the queried pages.

categories

List all categories the pages belong to.

categoryinfo

Returns information about the given categories.

contributors

Get the list of logged-in contributors and the count of anonymous contributors to a page.

deletedrevisions

Get deleted revision information.

duplicatefiles

List all files that are duplicates of the given files based on hash values.

extlinks

Returns all external URLs (not interwikis) from the given pages.

fileusage

Find all pages that use the given files.

imageinfo

Returns file information and upload history.

images

Returns all files contained on the given pages.

info

Get basic page information.

iwlinks

Returns all interwiki links from the given pages.

langlinks

Returns all interlanguage links from the given pages.

links

Returns all links from the given pages.

linkshere

Find all pages that link to the given pages.

pageprops

Get various page properties defined in the page content.

redirects

Returns all redirects to the given pages.

revisions

Get revision information.

stashimageinfo

Returns file information for stashed files.

templates

Returns all pages transcluded on the given pages.

transcludedin

Find all pages that transclude the given pages.

Which lists to get.

allcategories

Enumerate all categories.

alldeletedrevisions

List all deleted revisions by a user or in a namespace.

allfileusages

List all file usages, including non-existing.

allimages

Enumerate all images sequentially.

alllinks

Enumerate all links that point to a given namespace.

allpages

Enumerate all pages sequentially in a given namespace.

allredirects

List all redirects to a namespace.

allrevisions

List all revisions.

alltransclusions

List all transclusions (pages embedded using {{x}}), including non-existing.

allusers

Enumerate all registered users.

backlinks

Find all pages that link to the given page.

blocks

List all blocked users and IP addresses.

categorymembers

List all pages in a given category.

embeddedin

Find all pages that embed (transclude) the given title.

exturlusage

Enumerate pages that contain a given URL.

filearchive

Enumerate all deleted files sequentially.

imageusage

Find all pages that use the given image title.

iwbacklinks

Find all pages that link to the given interwiki link.

langbacklinks

Find all pages that link to the given language link.

logevents

Get events from logs.

mystashedfiles

Get a list of files in the current user's upload stash.

pagepropnames

List all page property names in use on the wiki.

pageswithprop

List all pages using a given page property.

prefixsearch

Perform a prefix search for page titles.

protectedtitles

List all titles protected from creation.

querypage

Get a list provided by a QueryPage-based special page.

random

Get a set of random pages.

recentchanges

Enumerate recent changes.

search

Perform a full text search.

tags

List change tags.

usercontribs

Get all edits by a user.

users

Get information about a list of users.

watchlist

Get recent changes to pages in the current user's watchlist.

watchlistraw

Get all pages on the current user's watchlist.

deletedrevs

Deprecated. List deleted revisions.

Which metadata to get.

allmessages

Return messages from this site.

authmanagerinfo

Retrieve information about the current authentication status.

filerepoinfo

Return meta information about image repositories configured on the wiki.

languageinfo

Return information about available languages.

siteinfo

Return general information about the site.

tokens

Gets tokens for data-modifying actions.

userinfo

Get information about the current user.

Include an additional pageids section listing all returned page IDs.

Export the current revisions of all given or generated pages.

Return the export XML without wrapping it in an XML result (same format as Special:Export). Can only be used with query+export.

Target the given version of the XML dump format when exporting. Can only be used with query+export.

Whether to get the full URL if the title is an interwiki link.

When more results are available, use this to continue.

Return raw query-continue data for continuation.

A list of titles to work on.

A list of page IDs to work on.

A list of revision IDs to work on.

Get the list of pages to work on by executing the specified query module.

Note: Generator parameter names must be prefixed with a "g", see examples.

allcategories

Enumerate all categories.

alldeletedrevisions

List all deleted revisions by a user or in a namespace.

allfileusages

List all file usages, including non-existing.

allimages

Enumerate all images sequentially.

alllinks

Enumerate all links that point to a given namespace.

allpages

Enumerate all pages sequentially in a given namespace.

allredirects

List all redirects to a namespace.

allrevisions

List all revisions.

alltransclusions

List all transclusions (pages embedded using {{x}}), including non-existing.

backlinks

Find all pages that link to the given page.

categories

List all categories the pages belong to.

categorymembers

List all pages in a given category.

deletedrevisions

Get deleted revision information.

duplicatefiles

List all files that are duplicates of the given files based on hash values.

embeddedin

Find all pages that embed (transclude) the given title.

exturlusage

Enumerate pages that contain a given URL.

fileusage

Find all pages that use the given files.

images

Returns all files contained on the given pages.

imageusage

Find all pages that use the given image title.

iwbacklinks

Find all pages that link to the given interwiki link.

langbacklinks

Find all pages that link to the given language link.

links

Returns all links from the given pages.

linkshere

Find all pages that link to the given pages.

pageswithprop

List all pages using a given page property.

prefixsearch

Perform a prefix search for page titles.

protectedtitles

List all titles protected from creation.

querypage

Get a list provided by a QueryPage-based special page.

random

Get a set of random pages.

recentchanges

Enumerate recent changes.

redirects

Returns all redirects to the given pages.

revisions

Get revision information.

search

Perform a full text search.

templates

Returns all pages transcluded on the given pages.

transcludedin

Find all pages that transclude the given pages.

watchlist

Get recent changes to pages in the current user's watchlist.

watchlistraw

Get all pages on the current user's watchlist.

Automatically resolve redirects in query+titles, query+pageids, and query+revids, and in pages returned by query+generator.

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include en, crh, gan, iu, kk, ku, shi, sr, tg, uz and zh.

Which additional properties to get for each category:

sortkey

Adds the sortkey (hexadecimal string) and sortkey prefix (human-readable part) for the category.

timestamp

Adds timestamp of when the category was added.

hidden

Tags categories that are hidden with __HIDDENCAT__.

Which kind of categories to show.

How many categories to return.

When more results are available, use this to continue.

Only list these categories. Useful for checking whether a certain page is in a certain category.

The direction in which to list.

When more results are available, use this to continue.

Only include users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.

Exclude users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.

Only include users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.

Exclude users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.

How many contributors to return.

When more results are available, use this to continue.

Which properties to get for each revision:

ids

The ID of the revision.

flags

Revision flags (minor).

timestamp

The timestamp of the revision.

user

User that made the revision.

userid

User ID of the revision creator.

size

Length (bytes) of the revision.

slotsize

Length (bytes) of each revision slot.

sha1

SHA-1 (base 16) of the revision.

slotsha1

SHA-1 (base 16) of each revision slot.

contentmodel

Content model ID of each revision slot.

comment

Comment by the user for the revision.

parsedcomment

Parsed comment by the user for the revision.

content

Content of each revision slot.

tags

Tags for the revision.

roles

List content slot roles that exist in the revision.

parsetree

Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Which revision slots to return data for, when slot-related properties are included in drvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.

Limit how many revisions will be returned.

Use action=expandtemplates instead. Expand templates in revision content (requires drvprop=content).

Use action=expandtemplates or action=parse instead. Generate XML parse tree for revision content (requires drvprop=content).

Use action=parse instead. Parse revision content (requires drvprop=content). For performance reasons, if this option is used, drvlimit is enforced to 1.

Only retrieve the content of this section number.

Use action=compare instead. Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

Use action=compare instead. Text to diff each revision to. Only diffs a limited number of revisions. Overrides drvdiffto. If drvsection is set, only that section will be diffed against this text.

Use action=compare instead. Perform a pre-save transform on the text before diffing it. Only valid when used with drvdifftotext.

Serialization format used for drvdifftotext and expected for output of content.

The timestamp to start enumerating from. Ignored when processing a list of revision IDs.

The timestamp to stop enumerating at. Ignored when processing a list of revision IDs.

In which direction to enumerate:

newer

List oldest first. Note: drvstart has to be before drvend.

older

List newest first (default). Note: drvstart has to be later than drvend.

Only list revisions tagged with this tag.

Only list revisions by this user.

Don't list revisions by this user.

When more results are available, use this to continue.

How many duplicate files to return.

When more results are available, use this to continue.

The direction in which to list.

Look only for files in the local repository.

How many links to return.

When more results are available, use this to continue.

Protocol of the URL. If empty and elquery is set, the protocol is http. Leave both this and elquery empty to list all external links.

Search string without protocol. Useful for checking whether a certain page contains a certain external url.

Expand protocol-relative URLs with the canonical protocol.

Which properties to get:

pageid

Page ID of each page.

title

Title of each page.

redirect

Flag if the page is a redirect.

Only include pages in these namespaces.

Show only items that meet these criteria:

redirect

Only show redirects.

!redirect

Only show non-redirects.

How many to return.

When more results are available, use this to continue.

Which file information to get:

timestamp

Adds timestamp for the uploaded version.

user

Adds the user who uploaded each file version.

userid

Add the ID of the user that uploaded each file version.

comment

Comment on the version.

parsedcomment

Parse the comment on the version.

canonicaltitle

Adds the canonical title of the file.

url

Gives URL to the file and the description page.

size

Adds the size of the file in bytes and the height, width and page count (if applicable).

dimensions

Alias for size.

sha1

Adds SHA-1 hash for the file.

mime

Adds MIME type of the file.

thumbmime

Adds MIME type of the image thumbnail (requires url and param iiurlwidth).

mediatype

Adds the media type of the file.

metadata

Lists Exif metadata for the version of the file.

commonmetadata

Lists file format generic metadata for the version of the file.

extmetadata

Lists formatted metadata combined from multiple sources. Results are HTML formatted.

archivename

Adds the filename of the archive version for non-latest versions.

bitdepth

Adds the bit depth of the version.

uploadwarning

Used by the Special:Upload page to get information about an existing file. Not intended for use outside MediaWiki core.

badfile

Adds whether the file is on the MediaWiki:Bad image list

How many file revisions to return per file.

Timestamp to start listing from.

Timestamp to stop listing at.

If iiprop=url is set, a URL to an image scaled to this width will be returned. For performance reasons if this option is used, no more than 50 scaled images will be returned.

Similar to iiurlwidth.

Version of metadata to use. If latest is specified, use latest version. Defaults to 1 for backwards compatibility.

What language to fetch extmetadata in. This affects both which translation to fetch, if multiple are available, as well as how things like numbers and various values are formatted.

If translations for extmetadata property are available, fetch all of them.

If specified and non-empty, only these keys will be returned for iiprop=extmetadata.

A handler specific parameter string. For example, PDFs might use page15-100px. iiurlwidth must be used and be consistent with iiurlparam.

If badfilecontexttitleprop=badfile is set, this is the page title used when evaluating the MediaWiki:Bad image list

When more results are available, use this to continue.

Look only for files in the local repository.

How many files to return.

When more results are available, use this to continue.

Only list these files. Useful for checking whether a certain page has a certain file.

The direction in which to list.

Which additional properties to get:

protection

List the protection level of each page.

talkid

The page ID of the talk page for each non-talk page.

watched

List the watched status of each page.

watchers

The number of watchers, if allowed.

visitingwatchers

The number of watchers of each page who have visited recent edits to that page, if allowed.

notificationtimestamp

The watchlist notification timestamp of each page.

subjectid

The page ID of the parent page for each talk page.

url

Gives a full URL, an edit URL, and the canonical URL for each page.

readable

Deprecated. Whether the user can read this page. Use intestactions=read instead.

preload

Gives the text returned by EditFormPreloadText.

displaytitle

Gives the manner in which the page title is actually displayed.

varianttitles

Gives the display title in all variants of the site content language.

Test whether the current user can perform certain actions on the page.

Detail level for intestactions. Use the main module's errorformat and errorlang parameters to control the format of the messages returned.

boolean

Return a boolean value for each action.

full

Return messages describing why the action is disallowed, or an empty array if it is allowed.

quick

Like full but skipping expensive checks.

Use action=query&meta=tokens instead.

When more results are available, use this to continue.

Which additional properties to get for each interlanguage link:

url

Adds the full URL.

Only return interwiki links with this prefix.

Interwiki link to search for. Must be used with iwprefix.

The direction in which to list.

How many interwiki links to return.

When more results are available, use this to continue.

Whether to get the full URL (cannot be used with iwprop).

Which additional properties to get for each interlanguage link:

url

Adds the full URL.

langname

Adds the localised language name (best effort). Use llinlanguagecode to control the language.

autonym

Adds the native language name.

Only return language links with this language code.

Link to search for. Must be used with lllang.

The direction in which to list.

Language code for localised language names.

How many langlinks to return.

When more results are available, use this to continue.

Whether to get the full URL (cannot be used with llprop).

Show links in these namespaces only.

How many links to return.

When more results are available, use this to continue.

Only list links to these titles. Useful for checking whether a certain page links to a certain title.

The direction in which to list.

Which properties to get:

pageid

Page ID of each page.

title

Title of each page.

redirect

Flag if the page is a redirect.

Only include pages in these namespaces.

Show only items that meet these criteria:

redirect

Only show redirects.

!redirect

Only show non-redirects.

How many to return.

When more results are available, use this to continue.

When more results are available, use this to continue.

Only list these page properties (action=query&list=pagepropnames returns page property names in use). Useful for checking whether pages use a certain page property.

Which properties to get:

pageid

Page ID of each redirect.

title

Title of each redirect.

fragment

Fragment of each redirect, if any.

Only include pages in these namespaces.

Show only items that meet these criteria:

fragment

Only show redirects with a fragment.

!fragment

Only show redirects without a fragment.

How many redirects to return.

When more results are available, use this to continue.

Which properties to get for each revision:

ids

The ID of the revision.

flags

Revision flags (minor).

timestamp

The timestamp of the revision.

user

User that made the revision.

userid

User ID of the revision creator.

size

Length (bytes) of the revision.

slotsize

Length (bytes) of each revision slot.

sha1

SHA-1 (base 16) of the revision.

slotsha1

SHA-1 (base 16) of each revision slot.

contentmodel

Content model ID of each revision slot.

comment

Comment by the user for the revision.

parsedcomment

Parsed comment by the user for the revision.

content

Content of each revision slot.

tags

Tags for the revision.

roles

List content slot roles that exist in the revision.

parsetree

Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.

Limit how many revisions will be returned.

Use action=expandtemplates instead. Expand templates in revision content (requires rvprop=content).

Use action=expandtemplates or action=parse instead. Generate XML parse tree for revision content (requires rvprop=content).

Use action=parse instead. Parse revision content (requires rvprop=content). For performance reasons, if this option is used, rvlimit is enforced to 1.

Only retrieve the content of this section number.

Use action=compare instead. Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

Use action=compare instead. Text to diff each revision to. Only diffs a limited number of revisions. Overrides rvdiffto. If rvsection is set, only that section will be diffed against this text.

Use action=compare instead. Perform a pre-save transform on the text before diffing it. Only valid when used with rvdifftotext.

Serialization format used for rvdifftotext and expected for output of content.

Start enumeration from this revision's timestamp. The revision must exist, but need not belong to this page.

Stop enumeration at this revision's timestamp. The revision must exist, but need not belong to this page.

From which revision timestamp to start enumeration.

Enumerate up to this timestamp.

In which direction to enumerate:

newer

List oldest first. Note: rvstart has to be before rvend.

older

List newest first (default). Note: rvstart has to be later than rvend.

Only include revisions made by user.

Exclude revisions made by user.

Only list revisions tagged with this tag.

Which tokens to obtain for each revision.

When more results are available, use this to continue.

Key that identifies a previous upload that was stashed temporarily.

Alias for siifilekey, for backward compatibility.

Which file information to get:

timestamp

Adds timestamp for the uploaded version.

canonicaltitle

Adds the canonical title of the file.

url

Gives URL to the file and the description page.

size

Adds the size of the file in bytes and the height, width and page count (if applicable).

dimensions

Alias for size.

sha1

Adds SHA-1 hash for the file.

mime

Adds MIME type of the file.

thumbmime

Adds MIME type of the image thumbnail (requires url and param siiurlwidth).

metadata

Lists Exif metadata for the version of the file.

commonmetadata

Lists file format generic metadata for the version of the file.

extmetadata

Lists formatted metadata combined from multiple sources. Results are HTML formatted.

bitdepth

Adds the bit depth of the version.

badfile

Adds whether the file is on the MediaWiki:Bad image list

If siiprop=url is set, a URL to an image scaled to this width will be returned. For performance reasons if this option is used, no more than 50 scaled images will be returned.

Similar to siiurlwidth.

A handler specific parameter string. For example, PDFs might use page15-100px. siiurlwidth must be used and be consistent with siiurlparam.

Show templates in these namespaces only.

How many templates to return.

When more results are available, use this to continue.

Only list these templates. Useful for checking whether a certain page uses a certain template.

The direction in which to list.

Which properties to get:

pageid

Page ID of each page.

title

Title of each page.

redirect

Flag if the page is a redirect.

Only include pages in these namespaces.

Show only items that meet these criteria:

redirect

Only show redirects.

!redirect

Only show non-redirects.

How many to return.

When more results are available, use this to continue.

The category to start enumerating from.

When more results are available, use this to continue.

The category to stop enumerating at.

Search for all category titles that begin with this value.

Direction to sort in.

Only return categories with at least this many members.

Only return categories with at most this many members.

How many categories to return.

Which properties to get:

size

Adds number of pages in the category.

hidden

Tags categories that are hidden with __HIDDENCAT__.