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
- Licence: 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 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.
- entityterms
- Get the terms (labels, descriptions and aliases) of the entity on this page.
- extlinks
- Returns all external URLs (not interwikis) from the given pages.
- extracts
- Returns plain-text or limited HTML extracts of 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.
- pageimages
- Returns information about images on the page, such as thumbnail and presence of photos.
- pageprops
- Get various page properties defined in the page content.
- pageterms
- Get the Vigyanwiki terms (typically labels, descriptions and aliases) associated with a page via a sitelink.
- 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.
- transcodestatus
- Get transcode status for a given file page.
- videoinfo
- Extends imageinfo to include video source (derivatives) information
- wbentityusage
- Returns all entity IDs used in the given pages.
- description
- Internal. Get a short description a.k.a. subtitle explaining what the target page is about.
- Values (separate with | or alternative): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, entityterms, extlinks, extracts, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageimages, pageprops, pageterms, redirects, revisions, stashimageinfo, templates, transcludedin, transcodestatus, videoinfo, wbentityusage, description
- 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.
- gadgetcategories
- Returns a list of gadget categories.
- gadgets
- Returns a list of gadgets used on this wiki.
- 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.
- wblistentityusage
- Returns all pages that use the given entity IDs.
- wbsubscribers
- Get subscriptions to given entities.
- deletedrevs
- Deprecated. List deleted revisions.
- wbsearch
- Internal. Searches for entities using labels and aliases.
- Values (separate with | or alternative): allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, blocks, categorymembers, embeddedin, exturlusage, filearchive, gadgetcategories, gadgets, imageusage, iwbacklinks, langbacklinks, logevents, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw, wblistentityusage, wbsubscribers, deletedrevs, wbsearch
- 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.
- wbcontentlanguages
- Returns information about the content languages Wikibase accepts in different contexts.
- wikibase
- Get information about the Wikibase client and the associated Wikibase repository.
- Values (separate with | or alternative): allmessages, authmanagerinfo, filerepoinfo, languageinfo, siteinfo, tokens, userinfo, wbcontentlanguages, wikibase
- 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.
- 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.
- 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.
- 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.
- wblistentityusage
- Returns all pages that use the given entity IDs.
- wbsearch
- Internal. Searches for entities using labels and aliases.
- 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, wblistentityusage, wbsearch
- 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, en, crh, gan, iu, kk, ku, shi, sr, tg, uz 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
- Licence: 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.
- 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
- Licence: GPL-2.0-or-later
Returns information about the given categories.
- cicontinue
When more results are available, use this to continue.
- 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
- Licence: GPL-2.0-or-later
Get the list of logged-in contributors and the count of anonymous 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, deletebatch, deletebatch-spoof, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmyuserjson, editmyuserjsredirect, editmywatchlist, editprotected, editsemiprotected, editsitecss, editsitejs, editsitejson, editusercss, edituserjs, edituserjson, gadgets-definition-edit, gadgets-edit, gtag-exempt, hideuser, import, importupload, interwiki, ipblock-exempt, item-merge, item-redirect, item-term, managechangetags, markbotedits, mergehistory, minoredit, move, move-categorypages, move-rootuserpages, move-subpages, movefile, nominornewtalk, noratelimit, nuke, override-export-depth, pagelang, patrol, patrolmarks, property-create, property-term, protect, purge, read, renameuser, replacetext, reupload, reupload-own, reupload-shared, rollback, sboverride, sendemail, siteadmin, skipcaptcha, spamblacklistlog, suppressionlog, suppressredirect, suppressrevision, tboverride, tboverride-account, titleblacklistlog, transcode-reset, transcode-status, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi
- 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, deletebatch, deletebatch-spoof, deletechangetags, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmyuserjson, editmyuserjsredirect, editmywatchlist, editprotected, editsemiprotected, editsitecss, editsitejs, editsitejson, editusercss, edituserjs, edituserjson, gadgets-definition-edit, gadgets-edit, gtag-exempt, hideuser, import, importupload, interwiki, ipblock-exempt, item-merge, item-redirect, item-term, managechangetags, markbotedits, mergehistory, minoredit, move, move-categorypages, move-rootuserpages, move-subpages, movefile, nominornewtalk, noratelimit, nuke, override-export-depth, pagelang, patrol, patrolmarks, property-create, property-term, protect, purge, read, renameuser, replacetext, reupload, reupload-own, reupload-shared, rollback, sboverride, sendemail, siteadmin, skipcaptcha, spamblacklistlog, suppressionlog, suppressredirect, suppressrevision, tboverride, tboverride-account, titleblacklistlog, transcode-reset, transcode-status, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi
- 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.
- Show contributors to the page Main Page.
- api.php?action=query&prop=contributors&titles=Main_Page [open in sandbox]
prop=deletedrevisions (drv)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- Licence: 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.
- 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).
- 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 *.
- drvlimit
Limit how many revisions will be returned.
- 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.
- 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
- Deprecated.
Serialisation format used for drvdifftotext and expected for output of content.
- One of the following values: application/json, application/octet-stream, application/unknown, application/vnd.php.serialized, 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, 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, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
- drvcontinue
When more results are available, use this to continue.
- 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&drvslots=*&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=description (desc)
- This module is internal or unstable. Its operation may change without notice.
- This module requires read rights.
- Source: WikibaseClient
- Licence: GPL-2.0-or-later
Get a short description a.k.a. subtitle explaining what the target page is about.
The description is plain text, on a single line, but otherwise arbitrary (potentially including raw HTML tags, which also should be interpreted as plain text). It must not be used in HTML unescaped!
- desccontinue
When more results are available, use this to continue.
- Type: integer
- Default: 0
- descprefersource
Which description source to prefer if present:
- local
- Local descriptions via
{{SHORTDESC:...}}parser function in the wikitext of the page. - central
- Central descriptions from the associated Vigyanwiki item.
- One of the following values: central, local
- Default: local
- Get the description for the page 'London'.
- api.php?action=query&prop=description&titles=London [open in sandbox]
- Get the description for the page 'London', preferring the central description if it exists.
- api.php?action=query&prop=description&titles=London&descprefersource=central [open in sandbox]
prop=duplicatefiles (df)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- Licence: 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.
- 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]](/wiki/Special:ApiSandbox#action=query&titles=File:Albert_Einstein_Head.jpg&prop=duplicatefiles){kind=link}
prop=entityterms (wbet)
- This module requires read rights.
- Source: WikibaseClient
- Licence: GPL-2.0-or-later
Get the terms (labels, descriptions and aliases) of the entity on this page.
- wbetcontinue
When more results are available, use this to continue.
- Type: integer
- wbetlanguage
The language code to get terms in. If not specified, the user language is used.
- One of the following values: aa, ab, abs, ace, ady, ady-cyrl, aeb, aeb-arab, aeb-latn, af, agq, ak, aln, als, alt, am, ami, an, ang, anp, ar, arc, arn, arq, ary, arz, as, ase, ast, atj, av, avk, awa, ay, az, azb, ba, bag, ban, ban-bali, bar, bas, bat-smg, bax, bbc, bbc-latn, bbj, bcc, bci, bcl, be, be-tarask, be-x-old, bfd, bg, bgn, bh, bho, bi, bjn, bkc, bkh, bkm, blk, bm, bn, bo, bpy, bqi, bqz, br, brh, bs, btm, bto, bug, bxr, byv, ca, cak, cbk-zam, cdo, ce, ceb, ch, cho, chr, chy, ckb, cnh, co, cps, cr, crh, crh-cyrl, crh-latn, cs, csb, cu, cv, cy, da, dag, de, de-at, de-ch, de-formal, din, diq, dsb, dtp, dty, dua, dv, dz, ee, egl, el, eml, en, en-ca, en-gb, en-us, eo, es, es-419, es-formal, et, eto, etu, eu, ewo, ext, fa, fat, ff, fi, fit, fiu-vro, fj, fkv, fmp, fo, fon, fr, frc, frp, frr, fur, fy, ga, gaa, gag, gan, gan-hans, gan-hant, gcr, gd, gl, gld, glk, gn, gom, gom-deva, gom-latn, gor, got, gpe, grc, gsw, gu, guc, gur, guw, gv, gya, ha, hak, haw, he, hi, hif, hif-latn, hil, ho, hr, hrx, hsb, hsn, ht, hu, hu-formal, hy, hyw, hz, ia, id, ie, ig, ii, ik, ike-cans, ike-latn, ilo, inh, io, is, isu, it, iu, ja, jam, jbo, jut, jv, ka, kaa, kab, kbd, kbd-cyrl, kbp, kcg, kea, ker, kg, khw, ki, kiu, kj, kjp, kk, kk-arab, kk-cn, kk-cyrl, kk-kz, kk-latn, kk-tr, kl, km, kn, ko, ko-kp, koi, kr, krc, kri, krj, krl, ks, ks-arab, ks-deva, ksf, ksh, ksw, ku, ku-arab, ku-latn, kum, kv, kw, ky, la, lad, lb, lbe, lem, lez, lfn, lg, li, lij, liv, lki, lld, lmo, ln, lns, lo, loz, lrc, lt, ltg, lus, luz, lv, lzh, lzz, mad, mai, map-bms, mcn, mcp, mdf, mg, mh, mhr, mi, min, mk, ml, mn, mni, mnw, mo, mos, mr, mrh, mrj, ms, ms-arab, mt, mua, mus, mwl, my, myv, mzn, na, nah, nan, nan-hani, nap, nb, nds, nds-nl, ne, new, ng, nge, nia, niu, nl, nl-informal, nla, nmg, nmz, nn, nnh, nnz, no, nod, nov, nqo, nrm, nso, nv, ny, nyn, nys, oc, ojb, olo, om, or, os, osa-latn, ota, pa, pag, pam, pap, pap-aw, pcd, pcm, pdc, pdt, pfl, pi, pih, pl, pms, pnb, pnt, prg, ps, pt, pt-br, pwn, qu, quc, qug, rgn, rif, rm, rmc, rmf, rmy, rn, ro, roa-rup, roa-tara, rsk, ru, rue, rup, ruq, ruq-cyrl, ruq-latn, rw, rwr, ryu, sa, sah, sat, sc, scn, sco, sd, sdc, sdh, se, se-fi, se-no, se-se, sei, ses, sg, sgs, sh, shi, shi-latn, shi-tfng, shn, shy, shy-latn, si, simple, sjd, sje, sju, sk, skr, skr-arab, sl, sli, sm, sma, smj, smn, sms, sn, so, sq, sr, sr-ec, sr-el, srn, sro, srq, ss, st, stq, sty, su, sv, sw, syl, szl, szy, ta, tay, tcy, tdd, te, tet, tg, tg-cyrl, tg-latn, th, ti, tk, tl, tly, tly-cyrl, tn, to, tpi, tr, tru, trv, ts, tt, tt-cyrl, tt-latn, tum, tvu, tw, ty, tyv, tzm, udm, ug, ug-arab, ug-latn, uk, ur, uselang, uz, uz-cyrl, uz-latn, ve, vec, vep, vi, vls, vmf, vmw, vo, vot, vro, vut, wa, war, wes, wls, wo, wuu, wya, xal, xh, xmf, xsy, yas, yat, yav, ybb, yi, yo, yrl, yue, za, zea, zgh, zh, zh-classical, zh-cn, zh-hans, zh-hant, zh-hk, zh-min-nan, zh-mo, zh-my, zh-sg, zh-tw, zh-yue, zu
- Default: uselang
- wbetterms
The types of terms to get, e.g. 'description', each returned as an array of strings keyed by their type, e.g. {"description": ["foo"]}. If not specified, all types are returned.
- Values (separate with | or alternative): alias, description, label
- Default: alias|label|description
- Get labels and aliases of item Q84.
- api.php?action=query&prop=entityterms&titles=Q84 [open in sandbox]
prop=extlinks (el)
- This module requires read rights.
- Source: MediaWiki
- Licence: 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.
- 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, matrix, 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)
- Get a list of external links on Main Page.
- api.php?action=query&prop=extlinks&titles=Main%20Page [open in sandbox]
prop=extracts (ex)
- This module requires read rights.
- Source: TextExtracts
- Licence: GPL-2.0-or-later
Returns plain-text or limited HTML extracts of the given pages.
- exchars
How many characters to return. Actual text returned might be slightly longer.
- Type: integer
- The value must be between 1 and 1,200.
- exsentences
How many sentences to return.
- Type: integer
- The value must be between 1 and 10.
- exlimit
How many extracts to return. (Multiple extracts can only be returned if exintro is set to true.)
- Type: integer or max
- The value must be between 1 and 20.
- Default: 20
- exintro
Return only content before the first section.
- Type: boolean (details)
- explaintext
Return extracts as plain text instead of limited HTML.
- Type: boolean (details)
- exsectionformat
How to format sections in plaintext mode:
- plain
- No formatting.
- wiki
- Wikitext-style formatting (== like this ==).
- raw
- This module's internal representation (section titles prefixed with <ASCII 1><ASCII 2><section level><ASCII 2><ASCII 1>).
- One of the following values: plain, raw, wiki
- Default: wiki
- excontinue
When more results are available, use this to continue.
- Type: integer
- Get a 175-character extract
- api.php?action=query&prop=extracts&exchars=175&titles=Therion [open in sandbox]
prop=fileusage (fu)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- Licence: 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, 120, 121, 122, 123, 710, 711, 828, 829, 2300, 2301, 2302, 2303, 3000, 3001
- 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.
- 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]](/wiki/Special:ApiSandbox#action=query&prop=fileusage&titles=File%3AExample.jpg){kind=link}
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&generator=fileusage&titles=File%3AExample.jpg&prop=info){kind=link}
prop=imageinfo (ii)
- This module requires read rights.
- Source: MediaWiki
- Licence: 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.
- 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-gb
- 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.
- 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]](/wiki/Special:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}
prop=images (im)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- Licence: 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.
- 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 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)
- This module requires read rights.
- Source: MediaWiki
- Licence: 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
- 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.
- 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, linkclasses, notificationtimestamp, preload, protection, subjectid, talkid, url, varianttitles, visitingwatchers, watched, watchers, 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
- incontinue
When more results are available, use this to continue.
- 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
- Licence: 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.
- 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]