MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/API

action=query

(main | query)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Fetch data from and about MediaWiki.

All data modifications will first have to use query to acquire a token to prevent abuse from malicious sites.

Parameters:

prop

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.

Values (separate with | or alternative): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageprops, redirects, revisions, stashimageinfo, templates, transcludedin

list

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.

Values (separate with | or alternative): allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, blocks, categorymembers, embeddedin, exturlusage, filearchive, imageusage, iwbacklinks, langbacklinks, logevents, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw, deletedrevs

meta

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.
siteinfo: Return general information about the site.
tokens: Gets tokens for data-modifying actions.
userinfo: Get information about the current user.

Values (separate with | or alternative): allmessages, authmanagerinfo, filerepoinfo, siteinfo, tokens, userinfo

indexpageids

Include an additional pageids section listing all returned page IDs.

Type: boolean (details)

export

Export the current revisions of all given or generated pages.

Type: boolean (details)

exportnowrap

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

Type: boolean (details)

iwurl

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

Type: boolean (details)

continue

When more results are available, use this to continue.

rawcontinue

Return raw query-continue data for continuation.

Type: boolean (details)

titles

A list of titles to work on.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

pageids

A list of page IDs to work on.

Type: list of integers

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

revids

A list of revision IDs to work on.

Type: list of integers

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

generator

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.

One of the following values: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw

redirects

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

Type: boolean (details)

converttitles

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.

Type: boolean (details)

Examples:

Fetch site info and revisions of Main Page.: api.php?action=query&prop=revisions&meta=siteinfo&titles=Main%20Page&rvprop=user|comment&continue= [open in sandbox]
Fetch revisions of pages beginning with API/.: api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue= [open in sandbox]

prop=categories (cl)

(main | query | categories)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

List all categories the pages belong to.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Categories

Parameters:

clprop

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__.

Values (separate with | or alternative): sortkey, timestamp, hidden

clshow

Which kind of categories to show.

Values (separate with | or alternative): hidden, !hidden

cllimit

How many categories to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

clcontinue

When more results are available, use this to continue.

clcategories

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

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

cldir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

Get a list of categories the page Albert Einstein belongs to.: api.php?action=query&prop=categories&titles=Albert%20Einstein [open in sandbox]
Get information about all categories used in the page Albert Einstein.: api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info [open in sandbox]

prop=categoryinfo (ci)

(main | query | categoryinfo)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns information about the given categories.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Categoryinfo

Parameter:

cicontinue: When more results are available, use this to continue.

Example:

Get information about Category:Foo and Category:Bar.: api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar [open in sandbox]

prop=contributors (pc)

(main | query | contributors)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Contributors

Parameters:

pcgroup: Only include users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.; Values (separate with | or alternative): bot, sysop, bureaucrat
pcexcludegroup: Exclude users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.; Values (separate with | or alternative): bot, sysop, bureaucrat
pcrights: Only include users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.; Values (separate with | or alternative): apihighlimits, applychangetags, autoconfirmed, autocreateaccount, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjson, editmyuserjs, editmywatchlist, editsemiprotected, editusercss, edituserjson, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, patrol, patrolmarks, protect, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi; Maximum number of values is 50 (500 for bots).
pcexcluderights: Exclude users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.; Values (separate with | or alternative): apihighlimits, applychangetags, autoconfirmed, autocreateaccount, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjson, editmyuserjs, editmywatchlist, editsemiprotected, editusercss, edituserjson, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, patrol, patrolmarks, protect, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi; Maximum number of values is 50 (500 for bots).
pclimit: How many contributors to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
pccontinue: When more results are available, use this to continue.

Example:

Show contributors to the page Main Page.: api.php?action=query&prop=contributors&titles=Main_Page [open in sandbox]

prop=deletedrevisions (drv)

(main | query | deletedrevisions)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Get deleted revision information.

May be used in several ways:

Get deleted revisions for a set of pages, by setting titles or pageids. Ordered by title and timestamp.
Get data about a set of deleted revisions by setting their IDs with revids. Ordered by revision ID.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Deletedrevisions

Parameters:

drvprop

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.
sha1: SHA-1 (base 16) of the revision.
contentmodel: Content model ID of the revision.
comment: Comment by the user for the revision.
parsedcomment: Parsed comment by the user for the revision.
content: Text of the revision.
tags: Tags for the revision.
parsetree: Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Values (separate with | or alternative): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree

Default: ids|timestamp|flags|comment|user

drvlimit

Limit how many revisions will be returned.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

drvexpandtemplates

Deprecated.

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

Type: boolean (details)

drvgeneratexml

Deprecated.

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

Type: boolean (details)

drvparse

Deprecated.

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

Type: boolean (details)

drvsection

Only retrieve the content of this section number.

drvdiffto

Deprecated.

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

drvdifftotext

Deprecated.

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.

drvdifftotextpst

Deprecated.

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

Type: boolean (details)

drvcontentformat

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

One of the following values: text/x-wiki, text/javascript, application/json, text/css, text/plain

drvstart

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

Type: timestamp (allowed formats)

drvend

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

Type: timestamp (allowed formats)

drvdir

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.

One of the following values: newer, older

Default: older

drvtag

Only list revisions tagged with this tag.

drvuser

Only list revisions by this user.

Type: user name

drvexcludeuser

Don't list revisions by this user.

Type: user name

drvcontinue

When more results are available, use this to continue.

Examples:

List the deleted revisions of the pages Main Page and Talk:Main Page, with content.: api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvprop=user|comment|content [open in sandbox]
List the information for deleted revision 123456.: api.php?action=query&prop=deletedrevisions&revids=123456 [open in sandbox]

prop=duplicatefiles (df)

(main | query | duplicatefiles)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Duplicatefiles

Parameters:

dflimit: How many duplicate files to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
dfcontinue: When more results are available, use this to continue.
dfdir: The direction in which to list.; One of the following values: ascending, descending; Default: ascending
dflocalonly: Look only for files in the local repository.; Type: boolean (details)

Examples:

Look for duplicates of File:Albert Einstein Head.jpg.: api.php?action=query&titles=File:Albert_Einstein_Head.jpg&prop=duplicatefiles [open in sandbox]
Look for duplicates of all files.: api.php?action=query&generator=allimages&prop=duplicatefiles [open in sandbox]

prop=extlinks (el)

(main | query | extlinks)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Extlinks

Parameters:

ellimit: How many links to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
eloffset: When more results are available, use this to continue.; Type: integer
elprotocol: 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.; One of the following values: Can be empty, or bitcoin, ftp, ftps, geo, git, gopher, http, https, irc, ircs, magnet, mailto, mms, news, nntp, redis, sftp, sip, sips, sms, ssh, svn, tel, telnet, urn, worldwind, xmpp; Default: (empty)
elquery: Search string without protocol. Useful for checking whether a certain page contains a certain external url.
elexpandurl: Expand protocol-relative URLs with the canonical protocol.; Type: boolean (details)

Example:

Get a list of external links on Main Page.: api.php?action=query&prop=extlinks&titles=Main%20Page [open in sandbox]

prop=fileusage (fu)

(main | query | fileusage)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Find all pages that use the given files.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Fileusage

Parameters:

fuprop

Which properties to get:

pageid: Page ID of each page.
title: Title of each page.
redirect: Flag if the page is a redirect.

Values (separate with | or alternative): pageid, title, redirect

Default: pageid|title|redirect

funamespace

Only include pages in these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

fushow

Show only items that meet these criteria:

redirect: Only show redirects.
!redirect: Only show non-redirects.

Values (separate with | or alternative): redirect, !redirect

fulimit

How many to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

fucontinue

When more results are available, use this to continue.

Examples:

Get a list of pages using File:Example.jpg.: api.php?action=query&prop=fileusage&titles=File%3AExample.jpg [open in sandbox]
Get information about pages using File:Example.jpg.: api.php?action=query&generator=fileusage&titles=File%3AExample.jpg&prop=info [open in sandbox]

prop=imageinfo (ii)

(main | query | imageinfo)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns file information and upload history.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Imageinfo

Parameters:

iiprop

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

Values (separate with | or alternative): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning, badfile

Default: timestamp|user

iilimit

How many file revisions to return per file.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 1

iistart

Timestamp to start listing from.

Type: timestamp (allowed formats)

iiend

Timestamp to stop listing at.

Type: timestamp (allowed formats)

iiurlwidth

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.

Type: integer

Default: -1

iiurlheight

Similar to iiurlwidth.

Type: integer

Default: -1

iimetadataversion

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

Default: 1

iiextmetadatalanguage

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.

Default: en

iiextmetadatamultilang

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

Type: boolean (details)

iiextmetadatafilter

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

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

iiurlparam

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

Default: (empty)

iibadfilecontexttitle

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

iicontinue

When more results are available, use this to continue.

iilocalonly

Look only for files in the local repository.

Type: boolean (details)

Examples:

Fetch information about the current version of File:Albert Einstein Head.jpg.: api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [open in sandbox]
Fetch information about versions of File:Test.jpg from 2008 and later.: api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [open in sandbox]

prop=images (im)

(main | query | images)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all files contained on the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Images

Parameters:

imlimit: How many files to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
imcontinue: When more results are available, use this to continue.
imimages: Only list these files. Useful for checking whether a certain page has a certain file.; Separate values with | or alternative. Maximum number of values is 50 (500 for bots).
imdir: The direction in which to list.; One of the following values: ascending, descending; Default: ascending

Examples:

Get a list of files used in the Main Page.: api.php?action=query&prop=images&titles=Main%20Page [open in sandbox]
Get information about all files used in the Main Page.: api.php?action=query&generator=images&titles=Main%20Page&prop=info [open in sandbox]

prop=info (in)

(main | query | info)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Get basic page information.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Info

Parameters:

inprop

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: Whether the user can read this page.
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.

Values (separate with | or alternative): protection, talkid, watched, watchers, visitingwatchers, notificationtimestamp, subjectid, url, readable, preload, displaytitle, varianttitles

intestactions

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

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

intoken

Deprecated.

Use action=query&meta=tokens instead.

Values (separate with | or alternative): edit, delete, protect, move, block, unblock, email, import, watch

incontinue

When more results are available, use this to continue.

Examples:

Get information about the page Main Page.: api.php?action=query&prop=info&titles=Main%20Page [open in sandbox]
Get general and protection information about the page Main Page.: api.php?action=query&prop=info&inprop=protection&titles=Main%20Page [open in sandbox]

prop=iwlinks (iw)

(main | query | iwlinks)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all interwiki links from the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Iwlinks

Parameters:

iwprop

Which additional properties to get for each interlanguage link:

url: Adds the full URL.

Values (separate with | or alternative): url

iwprefix

Only return interwiki links with this prefix.

iwtitle

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

iwdir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

iwlimit

How many interwiki links to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

iwcontinue

When more results are available, use this to continue.

iwurl

Deprecated.

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

Type: boolean (details)

Example:

Get interwiki links from the page Main Page.: api.php?action=query&prop=iwlinks&titles=Main%20Page [open in sandbox]

prop=langlinks (ll)

(main | query | langlinks)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all interlanguage links from the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Langlinks

Parameters:

llprop

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.

Values (separate with | or alternative): url, langname, autonym

lllang

Only return language links with this language code.

lltitle

Link to search for. Must be used with lllang.

lldir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

llinlanguagecode

Language code for localised language names.

Default: en

lllimit

How many langlinks to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

llcontinue

When more results are available, use this to continue.

llurl

Deprecated.

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

Type: boolean (details)

Example:

Get interlanguage links from the page Main Page.: api.php?action=query&prop=langlinks&titles=Main%20Page&redirects= [open in sandbox]

prop=links (pl)

(main | query | links)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all links from the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Links

Parameters:

plnamespace: Show links in these namespaces only.; Values (separate with | or alternative): -2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; To specify all values, use *.
pllimit: How many links to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
plcontinue: When more results are available, use this to continue.
pltitles: Only list links to these titles. Useful for checking whether a certain page links to a certain title.; Separate values with | or alternative. Maximum number of values is 50 (500 for bots).
pldir: The direction in which to list.; One of the following values: ascending, descending; Default: ascending

Examples:

Get links from the page Main Page: api.php?action=query&prop=links&titles=Main%20Page [open in sandbox]
Get information about the link pages in the page Main Page.: api.php?action=query&generator=links&titles=Main%20Page&prop=info [open in sandbox]
Get links from the page Main Page in the User and Template namespaces.: api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10 [open in sandbox]

prop=linkshere (lh)

(main | query | linkshere)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Find all pages that link to the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Linkshere

Parameters:

lhprop

Which properties to get:

pageid: Page ID of each page.
title: Title of each page.
redirect: Flag if the page is a redirect.

Values (separate with | or alternative): pageid, title, redirect

Default: pageid|title|redirect

lhnamespace

Only include pages in these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

lhshow

Show only items that meet these criteria:

redirect: Only show redirects.
!redirect: Only show non-redirects.

Values (separate with | or alternative): redirect, !redirect

lhlimit

How many to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

lhcontinue

When more results are available, use this to continue.

Examples:

Get a list of pages linking to the Main Page.: api.php?action=query&prop=linkshere&titles=Main%20Page [open in sandbox]
Get information about pages linking to the Main Page.: api.php?action=query&generator=linkshere&titles=Main%20Page&prop=info [open in sandbox]

prop=pageprops (pp)

(main | query | pageprops)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Get various page properties defined in the page content.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Pageprops

Parameters:

ppcontinue: When more results are available, use this to continue.
ppprop: 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.; Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

Example:

Get properties for the pages Main Page and MediaWiki.: api.php?action=query&prop=pageprops&titles=Main%20Page|MediaWiki [open in sandbox]

prop=redirects (rd)

(main | query | redirects)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all redirects to the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Redirects

Parameters:

rdprop

Which properties to get:

pageid: Page ID of each redirect.
title: Title of each redirect.
fragment: Fragment of each redirect, if any.

Values (separate with | or alternative): pageid, title, fragment

Default: pageid|title

rdnamespace

Only include pages in these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

rdshow

Show only items that meet these criteria:

fragment: Only show redirects with a fragment.
!fragment: Only show redirects without a fragment.

Values (separate with | or alternative): fragment, !fragment

rdlimit

How many redirects to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

rdcontinue

When more results are available, use this to continue.

Examples:

Get a list of redirects to the Main Page.: api.php?action=query&prop=redirects&titles=Main%20Page [open in sandbox]
Get information about all redirects to the Main Page.: api.php?action=query&generator=redirects&titles=Main%20Page&prop=info [open in sandbox]

prop=revisions (rv)

(main | query | revisions)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Get revision information.

May be used in several ways:

Get data about a set of pages (last revision), by setting titles or pageids.
Get revisions for one given page, by using titles or pageids with start, end, or limit.
Get data about a set of revisions by setting their IDs with revids.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Revisions

Parameters:

rvprop

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.
sha1: SHA-1 (base 16) of the revision.
contentmodel: Content model ID of the revision.
comment: Comment by the user for the revision.
parsedcomment: Parsed comment by the user for the revision.
content: Text of the revision.
tags: Tags for the revision.
parsetree: Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Values (separate with | or alternative): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree

Default: ids|timestamp|flags|comment|user

rvlimit

Limit how many revisions will be returned.

May only be used with a single page (mode #2).

No more than 500 (5,000 for bots) allowed.

Type: integer or max

rvexpandtemplates

Deprecated.

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

Type: boolean (details)

rvgeneratexml

Deprecated.

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

Type: boolean (details)

rvparse

Deprecated.

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

Type: boolean (details)

rvsection

Only retrieve the content of this section number.

rvdiffto

Deprecated.

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

rvdifftotext

Deprecated.

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.

rvdifftotextpst

Deprecated.

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

Type: boolean (details)

rvcontentformat

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

One of the following values: text/x-wiki, text/javascript, application/json, text/css, text/plain

rvstartid

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

May only be used with a single page (mode #2).

Type: integer

rvendid

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

May only be used with a single page (mode #2).

Type: integer

rvstart

From which revision timestamp to start enumeration.

May only be used with a single page (mode #2).

Type: timestamp (allowed formats)

rvend

Enumerate up to this timestamp.

May only be used with a single page (mode #2).

Type: timestamp (allowed formats)

rvdir

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.

May only be used with a single page (mode #2).

One of the following values: newer, older

Default: older

rvuser

Only include revisions made by user.

May only be used with a single page (mode #2).

Type: user name

rvexcludeuser

Exclude revisions made by user.

May only be used with a single page (mode #2).

Type: user name

rvtag

Only list revisions tagged with this tag.

rvtoken

Deprecated.

Which tokens to obtain for each revision.

Values (separate with | or alternative): rollback

rvcontinue

When more results are available, use this to continue.

Examples:

Get data with content for the last revision of titles API and Main Page.: api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content [open in sandbox]
Get last 5 revisions of the Main Page.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [open in sandbox]
Get first 5 revisions of the Main Page.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [open in sandbox]
Get first 5 revisions of the Main Page made after 2006-05-01.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [open in sandbox]
Get first 5 revisions of the Main Page that were not made by anonymous user 127.0.0.1.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [open in sandbox]
Get first 5 revisions of the Main Page that were made by the user MediaWiki default.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [open in sandbox]

prop=stashimageinfo (sii)

(main | query | stashimageinfo)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns file information for stashed files.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Stashimageinfo

Parameters:

siifilekey

Key that identifies a previous upload that was stashed temporarily.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

siisessionkey

Deprecated.

Alias for siifilekey, for backward compatibility.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

siiprop

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

Values (separate with | or alternative): timestamp, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, metadata, commonmetadata, extmetadata, bitdepth, badfile

Default: timestamp|url

siiurlwidth

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.

Type: integer

Default: -1

siiurlheight

Similar to siiurlwidth.

Type: integer

Default: -1

siiurlparam

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

Default: (empty)

Examples:

Returns information for a stashed file.: api.php?action=query&prop=stashimageinfo&siifilekey=124sd34rsdf567 [open in sandbox]
Returns thumbnails for two stashed files.: api.php?action=query&prop=stashimageinfo&siifilekey=b34edoe3|bceffd4&siiurlwidth=120&siiprop=url [open in sandbox]

prop=templates (tl)

(main | query | templates)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Returns all pages transcluded on the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Templates

Parameters:

tlnamespace: Show templates in these namespaces only.; Values (separate with | or alternative): -2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; To specify all values, use *.
tllimit: How many templates to return.; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
tlcontinue: When more results are available, use this to continue.
tltemplates: Only list these templates. Useful for checking whether a certain page uses a certain template.; Separate values with | or alternative. Maximum number of values is 50 (500 for bots).
tldir: The direction in which to list.; One of the following values: ascending, descending; Default: ascending

Examples:

Get the templates used on the page Main Page.: api.php?action=query&prop=templates&titles=Main%20Page [open in sandbox]
Get information about the template pages used on Main Page.: api.php?action=query&generator=templates&titles=Main%20Page&prop=info [open in sandbox]
Get pages in the User and Template namespaces that are transcluded on the page Main Page.: api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10 [open in sandbox]

prop=transcludedin (ti)

(main | query | transcludedin)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Find all pages that transclude the given pages.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Transcludedin

Parameters:

tiprop

Which properties to get:

pageid: Page ID of each page.
title: Title of each page.
redirect: Flag if the page is a redirect.

Values (separate with | or alternative): pageid, title, redirect

Default: pageid|title|redirect

tinamespace

Only include pages in these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

tishow

Show only items that meet these criteria:

redirect: Only show redirects.
!redirect: Only show non-redirects.

Values (separate with | or alternative): redirect, !redirect

tilimit

How many to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

ticontinue

When more results are available, use this to continue.

Examples:

Get a list of pages transcluding Main Page.: api.php?action=query&prop=transcludedin&titles=Main%20Page [open in sandbox]
Get information about pages transcluding Main Page.: api.php?action=query&generator=transcludedin&titles=Main%20Page&prop=info [open in sandbox]

list=allcategories (ac)

(main | query | allcategories)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Enumerate all categories.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allcategories

Parameters:

acfrom

The category to start enumerating from.

accontinue

When more results are available, use this to continue.

acto

The category to stop enumerating at.

acprefix

Search for all category titles that begin with this value.

acdir

Direction to sort in.

One of the following values: ascending, descending

Default: ascending

acmin

Only return categories with at least this many members.

Type: integer

acmax

Only return categories with at most this many members.

Type: integer

aclimit

How many categories to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

acprop

Which properties to get:

size: Adds number of pages in the category.
hidden: Tags categories that are hidden with __HIDDENCAT__.

Values (separate with | or alternative): size, hidden

Default: (empty)

Examples:

List categories with information on the number of pages in each.: api.php?action=query&list=allcategories&acprop=size [open in sandbox]
Retrieve info about the category page itself for categories beginning List.: api.php?action=query&generator=allcategories&gacprefix=List&prop=info [open in sandbox]

list=alldeletedrevisions (adr)

(main | query | alldeletedrevisions)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Alldeletedrevisions

Parameters:

adrprop

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.
sha1: SHA-1 (base 16) of the revision.
contentmodel: Content model ID of the revision.
comment: Comment by the user for the revision.
parsedcomment: Parsed comment by the user for the revision.
content: Text of the revision.
tags: Tags for the revision.
parsetree: Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Values (separate with | or alternative): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree

Default: ids|timestamp|flags|comment|user

adrlimit

Limit how many revisions will be returned.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

adrexpandtemplates

Deprecated.

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

Type: boolean (details)

adrgeneratexml

Deprecated.

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

Type: boolean (details)

adrparse

Deprecated.

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

Type: boolean (details)

adrsection

Only retrieve the content of this section number.

adrdiffto

Deprecated.

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

adrdifftotext

Deprecated.

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

adrdifftotextpst

Deprecated.

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

Type: boolean (details)

adrcontentformat

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

One of the following values: text/x-wiki, text/javascript, application/json, text/css, text/plain

adruser

Only list revisions by this user.

Type: user name

adrnamespace

Only list pages in this namespace.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

adrstart

The timestamp to start enumerating from.

May only be used with adruser.

Type: timestamp (allowed formats)

adrend

The timestamp to stop enumerating at.

May only be used with adruser.

Type: timestamp (allowed formats)

adrdir

In which direction to enumerate:

newer: List oldest first. Note: adrstart has to be before adrend.
older: List newest first (default). Note: adrstart has to be later than adrend.

One of the following values: newer, older

Default: older

adrfrom

Start listing at this title.

Cannot be used with adruser.

adrto

Stop listing at this title.

Cannot be used with adruser.

adrprefix

Search for all page titles that begin with this value.

Cannot be used with adruser.

adrexcludeuser

Don't list revisions by this user.

Cannot be used with adruser.

Type: user name

adrtag

Only list revisions tagged with this tag.

adrcontinue

When more results are available, use this to continue.

adrgeneratetitles

When being used as a generator, generate titles rather than revision IDs.

Type: boolean (details)

Examples:

List the last 50 deleted contributions by user Example.: api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50 [open in sandbox]
List the first 50 deleted revisions in the main namespace.: api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrnamespace=0&adrlimit=50 [open in sandbox]

list=allfileusages (af)

(main | query | allfileusages)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

List all file usages, including non-existing.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allfileusages

Parameters:

afcontinue

When more results are available, use this to continue.

affrom

The title of the file to start enumerating from.

afto

The title of the file to stop enumerating at.

afprefix

Search for all file titles that begin with this value.

afunique

Only show distinct file titles. Cannot be used with afprop=ids. When used as a generator, yields target pages instead of source pages.

Type: boolean (details)

afprop

Which pieces of information to include:

ids: Adds the page IDs of the using pages (cannot be used with afunique).
title: Adds the title of the file.

Values (separate with | or alternative): ids, title

Default: title

aflimit

How many total items to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

afdir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

List file titles, including missing ones, with page IDs they are from, starting at B.: api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title [open in sandbox]
List unique file titles.: api.php?action=query&list=allfileusages&afunique=&affrom=B [open in sandbox]
Gets all file titles, marking the missing ones.: api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B [open in sandbox]
Gets pages containing the files.: api.php?action=query&generator=allfileusages&gaffrom=B [open in sandbox]

list=allimages (ai)

(main | query | allimages)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Enumerate all images sequentially.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allimages

Parameters:

aisort

Property to sort by.

One of the following values: name, timestamp

Default: name

aidir

The direction in which to list.

One of the following values: ascending, descending, newer, older

Default: ascending

aifrom

The image title to start enumerating from. Can only be used with aisort=name.

aito

The image title to stop enumerating at. Can only be used with aisort=name.

aicontinue

When more results are available, use this to continue.

aistart

The timestamp to start enumerating from. Can only be used with aisort=timestamp.

Type: timestamp (allowed formats)

aiend

The timestamp to end enumerating. Can only be used with aisort=timestamp.

Type: timestamp (allowed formats)

aiprop

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.
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.
bitdepth: Adds the bit depth of the version.
badfile: Adds whether the file is on the MediaWiki:Bad image list

Values (separate with | or alternative): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, mediatype, metadata, commonmetadata, extmetadata, bitdepth, badfile

Default: timestamp|url

aiprefix

Search for all image titles that begin with this value. Can only be used with aisort=name.

aiminsize

Limit to images with at least this many bytes.

Type: integer

aimaxsize

Limit to images with at most this many bytes.

Type: integer

aisha1

SHA1 hash of image. Overrides aisha1base36.

aisha1base36

SHA1 hash of image in base 36 (used in MediaWiki).

aiuser

Only return files uploaded by this user. Can only be used with aisort=timestamp. Cannot be used together with aifilterbots.

Type: user name

aifilterbots

How to filter files uploaded by bots. Can only be used with aisort=timestamp. Cannot be used together with aiuser.

One of the following values: all, bots, nobots

Default: all

aimime

What MIME types to search for, e.g. image/jpeg.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

ailimit

How many images in total to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

Examples:

Show a list of files starting at the letter B.: api.php?action=query&list=allimages&aifrom=B [open in sandbox]
Show a list of recently uploaded files, similar to Special:NewFiles.: api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older [open in sandbox]
Show a list of files with MIME type image/png or image/gif: api.php?action=query&list=allimages&aimime=image/png|image/gif [open in sandbox]
Show info about 4 files starting at the letter T.: api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo [open in sandbox]

list=alllinks (al)

(main | query | alllinks)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Enumerate all links that point to a given namespace.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Alllinks

Parameters:

alcontinue

When more results are available, use this to continue.

alfrom

The title of the link to start enumerating from.

alto

The title of the link to stop enumerating at.

alprefix

Search for all linked titles that begin with this value.

alunique

Only show distinct linked titles. Cannot be used with alprop=ids. When used as a generator, yields target pages instead of source pages.

Type: boolean (details)

alprop

Which pieces of information to include:

ids: Adds the page ID of the linking page (cannot be used with alunique).
title: Adds the title of the link.

Values (separate with | or alternative): ids, title

Default: title

alnamespace

The namespace to enumerate.

One of the following values: -2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Default: 0

allimit

How many total items to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

aldir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

List linked titles, including missing ones, with page IDs they are from, starting at B.: api.php?action=query&list=alllinks&alfrom=B&alprop=ids|title [open in sandbox]
List unique linked titles.: api.php?action=query&list=alllinks&alunique=&alfrom=B [open in sandbox]
Gets all linked titles, marking the missing ones.: api.php?action=query&generator=alllinks&galunique=&galfrom=B [open in sandbox]
Gets pages containing the links.: api.php?action=query&generator=alllinks&galfrom=B [open in sandbox]

list=allpages (ap)

(main | query | allpages)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Enumerate all pages sequentially in a given namespace.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allpages

Parameters:

apfrom

The page title to start enumerating from.

apcontinue

When more results are available, use this to continue.

apto

The page title to stop enumerating at.

apprefix

Search for all page titles that begin with this value.

apnamespace

The namespace to enumerate.

One of the following values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Default: 0

apfilterredir

Which pages to list.

One of the following values: all, redirects, nonredirects

Default: all

apminsize

Limit to pages with at least this many bytes.

Type: integer

apmaxsize

Limit to pages with at most this many bytes.

Type: integer

apprtype

Limit to protected pages only.

Values (separate with | or alternative): edit, move, upload

apprlevel

Filter protections based on protection level (must be used with apprtype= parameter).

Values (separate with | or alternative): Can be empty, or autoconfirmed, sysop

apprfiltercascade

Filter protections based on cascadingness (ignored when apprtype isn't set).

One of the following values: cascading, noncascading, all

Default: all

aplimit

How many total pages to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

apdir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

apfilterlanglinks

Filter based on whether a page has langlinks. Note that this may not consider langlinks added by extensions.

One of the following values: withlanglinks, withoutlanglinks, all

Default: all

apprexpiry

Which protection expiry to filter the page on:

indefinite: Get only pages with indefinite protection expiry.
definite: Get only pages with a definite (specific) protection expiry.
all: Get pages with any protections expiry.

One of the following values: indefinite, definite, all

Default: all

Examples:

Show a list of pages starting at the letter B.: api.php?action=query&list=allpages&apfrom=B [open in sandbox]
Show info about 4 pages starting at the letter T.: api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info [open in sandbox]
Show content of first 2 non-redirect pages beginning at Re.: api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content [open in sandbox]

list=allredirects (ar)

(main | query | allredirects)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

List all redirects to a namespace.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allredirects

Parameters:

arcontinue

When more results are available, use this to continue.

arfrom

The title of the redirect to start enumerating from.

arto

The title of the redirect to stop enumerating at.

arprefix

Search for all target pages that begin with this value.

arunique

Only show distinct target pages. Cannot be used with arprop=ids|fragment|interwiki. When used as a generator, yields target pages instead of source pages.

Type: boolean (details)

arprop

Which pieces of information to include:

ids: Adds the page ID of the redirecting page (cannot be used with arunique).
title: Adds the title of the redirect.
fragment: Adds the fragment from the redirect, if any (cannot be used with arunique).
interwiki: Adds the interwiki prefix from the redirect, if any (cannot be used with arunique).

Values (separate with | or alternative): ids, title, fragment, interwiki

Default: title

arnamespace

The namespace to enumerate.

One of the following values: -2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Default: 0

arlimit

How many total items to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

ardir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

List target pages, including missing ones, with page IDs they are from, starting at B.: api.php?action=query&list=allredirects&arfrom=B&arprop=ids|title [open in sandbox]
List unique target pages.: api.php?action=query&list=allredirects&arunique=&arfrom=B [open in sandbox]
Gets all target pages, marking the missing ones.: api.php?action=query&generator=allredirects&garunique=&garfrom=B [open in sandbox]
Gets pages containing the redirects.: api.php?action=query&generator=allredirects&garfrom=B [open in sandbox]

list=allrevisions (arv)

(main | query | allrevisions)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

List all revisions.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allrevisions

Parameters:

arvprop

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.
sha1: SHA-1 (base 16) of the revision.
contentmodel: Content model ID of the revision.
comment: Comment by the user for the revision.
parsedcomment: Parsed comment by the user for the revision.
content: Text of the revision.
tags: Tags for the revision.
parsetree: Deprecated. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).

Values (separate with | or alternative): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree

Default: ids|timestamp|flags|comment|user

arvlimit

Limit how many revisions will be returned.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

arvexpandtemplates

Deprecated.

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

Type: boolean (details)

arvgeneratexml

Deprecated.

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

Type: boolean (details)

arvparse

Deprecated.

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

Type: boolean (details)

arvsection

Only retrieve the content of this section number.

arvdiffto

Deprecated.

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

arvdifftotext

Deprecated.

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

arvdifftotextpst

Deprecated.

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

Type: boolean (details)

arvcontentformat

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

One of the following values: text/x-wiki, text/javascript, application/json, text/css, text/plain

arvuser

Only list revisions by this user.

Type: user name

arvnamespace

Only list pages in this namespace.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

To specify all values, use *.

arvstart

The timestamp to start enumerating from.

Type: timestamp (allowed formats)

arvend

The timestamp to stop enumerating at.

Type: timestamp (allowed formats)

arvdir

In which direction to enumerate:

newer: List oldest first. Note: arvstart has to be before arvend.
older: List newest first (default). Note: arvstart has to be later than arvend.

One of the following values: newer, older

Default: older

arvexcludeuser

Don't list revisions by this user.

Type: user name

arvcontinue

When more results are available, use this to continue.

arvgeneratetitles

When being used as a generator, generate titles rather than revision IDs.

Type: boolean (details)

Examples:

List the last 50 contributions by user Example.: api.php?action=query&list=allrevisions&arvuser=Example&arvlimit=50 [open in sandbox]
List the first 50 revisions in the main namespace.: api.php?action=query&list=allrevisions&arvdir=newer&arvlimit=50 [open in sandbox]

list=alltransclusions (at)

(main | query | alltransclusions)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Alltransclusions

Parameters:

atcontinue

When more results are available, use this to continue.

atfrom

The title of the transclusion to start enumerating from.

atto

The title of the transclusion to stop enumerating at.

atprefix

Search for all transcluded titles that begin with this value.

atunique

Only show distinct transcluded titles. Cannot be used with atprop=ids. When used as a generator, yields target pages instead of source pages.

Type: boolean (details)

atprop

Which pieces of information to include:

ids: Adds the page ID of the transcluding page (cannot be used with atunique).
title: Adds the title of the transclusion.

Values (separate with | or alternative): ids, title

Default: title

atnamespace

The namespace to enumerate.

One of the following values: -2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Default: 10

atlimit

How many total items to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

atdir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

List transcluded titles, including missing ones, with page IDs they are from, starting at B.: api.php?action=query&list=alltransclusions&atfrom=B&atprop=ids|title [open in sandbox]
List unique transcluded titles.: api.php?action=query&list=alltransclusions&atunique=&atfrom=B [open in sandbox]
Gets all transcluded titles, marking the missing ones.: api.php?action=query&generator=alltransclusions&gatunique=&gatfrom=B [open in sandbox]
Gets pages containing the transclusions.: api.php?action=query&generator=alltransclusions&gatfrom=B [open in sandbox]

list=allusers (au)

(main | query | allusers)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Enumerate all registered users.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allusers

Parameters:

aufrom

The user name to start enumerating from.

auto

The user name to stop enumerating at.

auprefix

Search for all users that begin with this value.

audir

Direction to sort in.

One of the following values: ascending, descending

Default: ascending

augroup

Only include users in the given groups.

Values (separate with | or alternative): bot, sysop, bureaucrat

auexcludegroup

Exclude users in the given groups.

Values (separate with | or alternative): bot, sysop, bureaucrat

aurights

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

Values (separate with | or alternative): apihighlimits, applychangetags, autoconfirmed, autocreateaccount, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjson, editmyuserjs, editmywatchlist, editsemiprotected, editusercss, edituserjson, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, patrol, patrolmarks, protect, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi

Maximum number of values is 50 (500 for bots).

auprop

Which pieces of information to include:

blockinfo: Adds the information about a current block on the user.
groups: Lists groups that the user is in. This uses more server resources and may return fewer results than the limit.
implicitgroups: Lists all the groups the user is automatically in.
rights: Lists rights that the user has.
editcount: Adds the edit count of the user.
registration: Adds the timestamp of when the user registered if available (may be blank).
centralids: Adds the central IDs and attachment status for the user.

Values (separate with | or alternative): blockinfo, groups, implicitgroups, rights, editcount, registration, centralids

aulimit

How many total user names to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

auwitheditsonly

Only list users who have made edits.

Type: boolean (details)

auactiveusers

Only list users active in the last 30 days.

Type: boolean (details)

auattachedwiki

With auprop=centralids, also indicate whether the user is attached with the wiki identified by this ID.

Example:

List users starting at Y.: api.php?action=query&list=allusers&aufrom=Y [open in sandbox]

list=backlinks (bl)

(main | query | backlinks)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

Find all pages that link to the given page.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Backlinks

Parameters:

bltitle: Title to search. Cannot be used together with blpageid.
blpageid: Page ID to search. Cannot be used together with bltitle.; Type: integer
blcontinue: When more results are available, use this to continue.
blnamespace: The namespace to enumerate.; Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; To specify all values, use *.
bldir: The direction in which to list.; One of the following values: ascending, descending; Default: ascending
blfilterredir: How to filter for redirects. If set to nonredirects when blredirect is enabled, this is only applied to the second level.; One of the following values: all, redirects, nonredirects; Default: all
bllimit: How many total pages to return. If blredirect is enabled, the limit applies to each level separately (which means up to 2 * bllimit results may be returned).; No more than 500 (5,000 for bots) allowed.; Type: integer or max; Default: 10
blredirect: If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.; Type: boolean (details)

Examples:

Show links to Main page.: api.php?action=query&list=backlinks&bltitle=Main%20Page [open in sandbox]
Get information about pages linking to Main page.: api.php?action=query&generator=backlinks&gbltitle=Main%20Page&prop=info [open in sandbox]

list=blocks (bk)

(main | query | blocks)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

List all blocked users and IP addresses.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Blocks

Parameters:

bkstart

The timestamp to start enumerating from.

Type: timestamp (allowed formats)

bkend

The timestamp to stop enumerating at.

Type: timestamp (allowed formats)

bkdir

In which direction to enumerate:

newer: List oldest first. Note: bkstart has to be before bkend.
older: List newest first (default). Note: bkstart has to be later than bkend.

One of the following values: newer, older

Default: older

bkids

List of block IDs to list (optional).

Type: list of integers

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

bkusers

List of users to search for (optional).

Type: list of user names

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

bkip

Get all blocks applying to this IP address or CIDR range, including range blocks. Cannot be used together with bkusers. CIDR ranges broader than IPv4/16 or IPv6/19 are not accepted.

bklimit

The maximum number of blocks to list.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

bkprop

Which properties to get:

id: Adds the ID of the block.
user: Adds the username of the blocked user.
userid: Adds the user ID of the blocked user.
by: Adds the username of the blocking user.
byid: Adds the user ID of the blocking user.
timestamp: Adds the timestamp of when the block was given.
expiry: Adds the timestamp of when the block expires.
reason: Adds the reason given for the block.
range: Adds the range of IP addresses affected by the block.
flags: Tags the ban with (autoblock, anononly, etc.).

Values (separate with | or alternative): id, user, userid, by, byid, timestamp, expiry, reason, range, flags

bkshow

Show only items that meet these criteria. For example, to see only indefinite blocks on IP addresses, set bkshow=ip|!temp.

Values (separate with | or alternative): account, !account, temp, !temp, ip, !ip, range, !range

bkcontinue

When more results are available, use this to continue.

Examples:

List blocks.: api.php?action=query&list=blocks [open in sandbox]
List blocks of users Alice and Bob.: api.php?action=query&list=blocks&bkusers=Alice|Bob [open in sandbox]

list=categorymembers (cm)

(main | query | categorymembers)

This module requires read rights.
This module can be used as a generator.
Source: MediaWiki
License: GPL-2.0-or-later

List all pages in a given category.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Categorymembers

Parameters:

cmtitle

Which category to enumerate (required). Must include the Category: prefix. Cannot be used together with cmpageid.

cmpageid

Page ID of the category to enumerate. Cannot be used together with cmtitle.

Type: integer

cmprop

Which pieces of information to include:

ids: Adds the page ID.
title: Adds the title and namespace ID of the page.
sortkey: Adds the sortkey used for sorting in the category (hexadecimal string).
sortkeyprefix: Adds the sortkey prefix used for sorting in the category (human-readable part of the sortkey).
type: Adds the type that the page has been categorised as (page, subcat or file).
timestamp: Adds the timestamp of when the page was included.

Values (separate with | or alternative): ids, title, sortkey, sortkeyprefix, type, timestamp

Default: ids|title

cmnamespace

Only include pages in these namespaces. Note that cmtype=subcat or cmtype=file may be used instead of cmnamespace=14 or 6.

Values (separate with | or