MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=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.
- 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 logged-out 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.
- codexicons
- Get Codex icons
- 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.
- trackingcategories
- Enumerate all existing tracking categories defined in Special:TrackingCategories. A tracking category exists if it contains pages or if its category page exists.
- 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, codexicons, embeddedin, exturlusage, filearchive, imageusage, iwbacklinks, langbacklinks, logevents, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, trackingcategories, 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.
- 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.
- Values (separate with | or alternative): allmessages, authmanagerinfo, filerepoinfo, languageinfo, 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)
- exportschema
Target the given version of the XML dump format when exporting. Can only be used with query+export.
- One of the following values: 0.10, 0.11
- Default: 0.11
- 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. More detailed information on how to continue queries can be found on mediawiki.org.
- 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 clients that are allowed higher limits).
- 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 clients that are allowed higher limits).
- revids
A list of revision IDs to work on. Note that almost all query modules will convert revision IDs to the corresponding page ID and work on the latest revision instead. Only prop=revisions uses exact revisions for its response.
- Type: list of integers
- Separate values with | or alternative.
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- 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.
- trackingcategories
- Enumerate all existing tracking categories defined in Special:TrackingCategories. A tracking category exists if it contains pages or if its category page exists.
- 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, trackingcategories, 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 ban, crh, en, gan, iu, ku, mni, sh, shi, sr, tg, tly, uz, wuu, zgh and zh.
- Type: boolean (details)
- 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)
- 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.
- 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): hidden, sortkey, timestamp
- clshow
Which kind of categories to show.
- Values (separate with | or alternative): !hidden, hidden
- cllimit
How many categories to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- clcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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 clients that are allowed higher limits).
- cldir
The direction in which to list.
- One of the following values: ascending, descending
- Default: ascending
- 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)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns information about the given categories.
- cicontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Get the list of logged-in contributors and the count of logged-out contributors to a page.
- 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, bureaucrat, interface-admin, suppress, sysop
- 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, bureaucrat, interface-admin, suppress, sysop
- 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, delete-redirect, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmyuserjson, editmyuserjsredirect, editmywatchlist, editprotected, editsemiprotected, editsitecss, editsitejs, editsitejson, editusercss, edituserjs, edituserjson, hideuser, import, importupload, interwiki, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, move-categorypages, move-rootuserpages, move-subpages, movefile, nominornewtalk, noratelimit, override-export-depth, pagelang, patrol, patrolmarks, protect, read, renameuser, renameuser-global, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- 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, delete-redirect, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmyuserjson, editmyuserjsredirect, editmywatchlist, editprotected, editsemiprotected, editsitecss, editsitejs, editsitejson, editusercss, edituserjs, edituserjson, hideuser, import, importupload, interwiki, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, move-categorypages, move-rootuserpages, move-subpages, movefile, nominornewtalk, noratelimit, override-export-depth, pagelang, patrol, patrolmarks, protect, read, renameuser, renameuser-global, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- pclimit
How many contributors to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- pccontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- Show contributors to the page Main Page.
- api.php?action=query&prop=contributors&titles=Main%20Page [open in sandbox]
prop=deletedrevisions (drv)
- 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.
- 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. If the user has been revision deleted, a userhidden property will be returned.
- userid
- User ID of the revision creator. If the user has been revision deleted, a userhidden property will be returned.
- size
- Length (bytes) of the revision.
- slotsize
- Length (bytes) of each revision slot.
- sha1
- SHA-1 (base 16) of the revision. If the content has been revision deleted, a sha1hidden property will be returned.
- slotsha1
- SHA-1 (base 16) of each revision slot. If the content has been revision deleted, a sha1hidden property will be returned.
- contentmodel
- Content model ID of each revision slot.
- comment
- Comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- parsedcomment
- Parsed comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- content
- Content of each revision slot. If the content has been revision deleted, a texthidden property will be returned. For performance reasons, if this option is used, drvlimit is enforced to 50.
- 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). For performance reasons, if this option is used, drvlimit is enforced to 50.
- Values (separate with | or alternative): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- Default: ids|timestamp|flags|comment|user
- drvslots
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.
- Values (separate with | or alternative): main
- To specify all values, use *.
- drvcontentformat-{slot}
Content serialization format used for output of content.
- This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of drvslots.
- One of the following values: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- drvlimit
Limit how many revisions will be returned. If drvprop=content, drvprop=parsetree, drvdiffto or drvdifftotext is used, the limit is 50. If drvparse is used, the limit is 1.
- Type: integer or max
- The value must be between 1 and 500.
- 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 the section with this identifier.
- 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. For performance reasons, if this option is used, drvlimit is enforced to 50.
- 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. For performance reasons, if this option is used, drvlimit is enforced to 50.
- 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
- Deprecated.
Serialization format used for drvdifftotext and expected for output of content.
- One of the following values: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- 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, by any of username, IP, Temporary user, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
- drvexcludeuser
Don't list revisions by this user.
- Type: user, by any of username, IP, Temporary user, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
- drvcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- List the information for deleted revision 123456.
- api.php?action=query&prop=deletedrevisions&revids=123456 [open in sandbox]
- List the deleted revisions of the pages Main Page and its talk page with content.
- api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk%3AMain%20Page&drvslots=*&drvprop=user|comment|content [open in sandbox]
prop=duplicatefiles (df)
- 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.
- dflimit
How many duplicate files to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- dfcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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)
- 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]
![[open in sandbox]](/index.php/Special:ApiSandbox#action=query&titles=File:Albert_Einstein_Head.jpg&prop=duplicatefiles){kind=link}
prop=extlinks (el)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns all external URLs (not interwikis) from the given pages.
- ellimit
How many links to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- elcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- elprotocol
Protocol of the URL. If empty and elquery is set, the protocol is http and https. 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, matrix, mms, news, nntp, redis, sftp, sip, sips, sms, ssh, svn, tel, telnet, urn, wikipedia, worldwind, xmpp
- Default: (empty)
- elquery
Search string without protocol. Useful for checking whether a certain page contains a certain external url.
- elexpandurl
- Deprecated.
Expand protocol-relative URLs with the canonical protocol.
- Type: boolean (details)
- Get a list of external links on the page Main Page.
- api.php?action=query&prop=extlinks&titles=Main%20Page [open in sandbox]
prop=fileusage (fu)
- 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.
- 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, redirect, title
- 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- fucontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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]
![[open in sandbox]](/index.php/Special:ApiSandbox#action=query&prop=fileusage&titles=File%3AExample.jpg){kind=link}
![[open in sandbox]](/index.php/Special:ApiSandbox#action=query&generator=fileusage&titles=File%3AExample.jpg&prop=info){kind=link}
prop=imageinfo (ii)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns file information and upload history.
- iiprop
Which file information to get:
- timestamp
- Adds timestamp for the uploaded version.
- user
- Adds the user who uploaded each file version. If the user has been revision deleted, a userhidden property will be returned.
- userid
- Add the ID of the user that uploaded each file version. If the user has been revision deleted, a userhidden property will be returned.
- comment
- Comment on the version. If the comment has been revision deleted, a commenthidden property will be returned.
- parsedcomment
- Parse the comment on the version. If the comment has been revision deleted, a commenthidden property will be returned.
- canonicaltitle
- Adds the canonical title of the file. If the file has been revision deleted, a filehidden property will be returned.
- url
- Gives URL to the file and the description page. If the file has been revision deleted, a filehidden property will be returned.
- 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. If the file has been revision deleted, a filehidden property will be returned.
- mime
- Adds MIME type of the file. If the file has been revision deleted, a filehidden property will be returned.
- thumbmime
- Adds MIME type of the image thumbnail (requires url and param iiurlwidth). If the file has been revision deleted, a filehidden property will be returned.
- mediatype
- Adds the media type of the file. If the file has been revision deleted, a filehidden property will be returned.
- metadata
- Lists Exif metadata for the version of the file. If the file has been revision deleted, a filehidden property will be returned.
- commonmetadata
- Lists file format generic metadata for the version of the file. If the file has been revision deleted, a filehidden property will be returned.
- extmetadata
- Lists formatted metadata combined from multiple sources. Results are HTML formatted. If the file has been revision deleted, a filehidden property will be returned.
Note: This is an expensive property to request, and should be avoided unless you need it. When using it, you should request only a few results at a time to avoid too much load.
- archivename
- Adds the filename of the archive version for non-latest versions. If the file has been revision deleted, a filehidden property will be returned.
- bitdepth
- Adds the bit depth of the version. If the file has been revision deleted, a filehidden property will be returned.
- 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): archivename, badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, thumbmime, timestamp, uploadwarning, url, user, userid
- Default: timestamp|user
- iilimit
How many file revisions to return per file.
- Type: integer or max
- The value must be between 1 and 500.
- 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 clients that are allowed higher limits).
- 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. More detailed information on how to continue queries can be found on mediawiki.org.
- iilocalonly
Look only for files in the local repository.
- Type: boolean (details)
- 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]
![[open in sandbox]](/index.php/Special:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[open in sandbox]](/index.php/Special:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url){kind=link}
prop=images (im)
- 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.
- imlimit
How many files to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- imcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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 clients that are allowed higher limits).
- imdir
The direction in which to list.
- One of the following values: ascending, descending
- Default: ascending
- Get a list of files used on the page Main Page.
- api.php?action=query&prop=images&titles=Main%20Page [open in sandbox]
- Get information about all files used on the page Main Page.
- api.php?action=query&generator=images&titles=Main%20Page&prop=info [open in sandbox]
prop=info (in)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Get basic page information.
- 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.
- associatedpage
- The prefixed title of the associated subject or 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
- Deprecated. Gives the text returned by EditFormPreloadText. Use preloadcontent instead, which supports other kinds of preloaded text too.
- preloadcontent
- Gives the content to be shown in the editor when the page does not exist or while adding a new section.
- editintro
- Gives the intro messages that should be shown to the user while editing this page or revision, as HTML.
- 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.
- linkclasses
- Gives the additional CSS classes (e.g. link colors) used for links to this page if they were to appear on the page named by inlinkcontext.
- Values (separate with | or alternative): associatedpage, displaytitle, editintro, linkclasses, notificationtimestamp, preloadcontent, protection, subjectid, talkid, url, varianttitles, visitingwatchers, watched, watchers, preload, readable
- inlinkcontext
The context title to use when determining extra CSS classes (e.g. link colors) when inprop contains linkclasses.
- Type: page title
- Accepts non-existent pages.
- Default: Main Page
- 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 clients that are allowed higher limits).
- intestactionsdetail
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.
- One of the following values: boolean, full, quick
- Default: boolean
- intestactionsautocreate
Test whether performing intestactions would automatically create a temporary account.
- Type: boolean (details)
- inpreloadcustom
Title of a custom page to use as preloaded content.
- Only used when inprop contains preloadcontent.
- inpreloadparams
Parameters for the custom page being used as preloaded content.
- Only used when inprop contains preloadcontent.
- Separate values with | or alternative.
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- inpreloadnewsection
Return preloaded content for a new section on the page, rather than a new page.
- Only used when inprop contains preloadcontent.
- Type: boolean (details)
- ineditintrostyle
Some intro messages come with optional wrapper frames. Use moreframes to include them or lessframes to omit them.
- Only used when inprop contains editintro.
- One of the following values: lessframes, moreframes
- Default: moreframes
- ineditintroskip
List of intro messages to remove from the response. Use this if a specific message is not relevant to your tool, or if the information is conveyed in a different way.
- Only used when inprop contains editintro.
- Separate values with | or alternative.
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- ineditintrocustom
Title of a custom page to use as an additional intro message.
- Only used when inprop contains editintro.
- incontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns all interwiki links from the given pages.
- iwprop
Which additional properties to get for each interwiki 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- iwcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- iwurl
- Deprecated.
Whether to get the full URL (cannot be used with iwprop).
- Type: boolean (details)
- Get interwiki links from the page Main Page.
- api.php?action=query&prop=iwlinks&titles=Main%20Page [open in sandbox]
prop=langlinks (ll)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns all interlanguage links from the given pages.
- 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): autonym, langname, url
- 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- llcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- llurl
- Deprecated.
Whether to get the full URL (cannot be used with llprop).
- Type: boolean (details)
- Get interlanguage links from the page Main Page.
- api.php?action=query&prop=langlinks&titles=Main%20Page&redirects= [open in sandbox]
prop=links (pl)
- 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.
- plnamespace
Show links in these namespaces only.
- Values (separate with | or alternative): -1, -2, 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- plcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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 clients that are allowed higher limits).
- pldir
The direction in which to list.
- One of the following values: ascending, descending
- Default: ascending
- 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)
- 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.
- 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, redirect, title
- 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- lhcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Get various page properties defined in the page content.
- ppcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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 clients that are allowed higher limits).
- 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)
- 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.
- 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): fragment, pageid, title
- 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.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- rdcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- 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)
- 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.
- 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. If the user has been revision deleted, a userhidden property will be returned.
- userid
- User ID of the revision creator. If the user has been revision deleted, a userhidden property will be returned.
- size
- Length (bytes) of the revision.
- slotsize
- Length (bytes) of each revision slot.
- sha1
- SHA-1 (base 16) of the revision. If the content has been revision deleted, a sha1hidden property will be returned.
- slotsha1
- SHA-1 (base 16) of each revision slot. If the content has been revision deleted, a sha1hidden property will be returned.
- contentmodel
- Content model ID of each revision slot.
- comment
- Comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- parsedcomment
- Parsed comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- content
- Content of each revision slot. If the content has been revision deleted, a texthidden property will be returned. For performance reasons, if this option is used, rvlimit is enforced to 50.
- 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). For performance reasons, if this option is used, rvlimit is enforced to 50.
- Values (separate with | or alternative): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree