API:Lists/All

From MediaWiki.org
Jump to: navigation, search

Ugly but useful view of all lists pages combined.

Contents

Allcategories[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.12

Get a list of all categories. This differs from list=allpages&alnamespace=14 in that categories without descriptions will be listed and, categories with descriptions but no actual pages may not (e.g., redirects and categories where a page was created but the category was never used). Note: the allcategories list also contains categories that have been deleted and are unused. It is recommended that the list be filtered to those where the size is greater than zero or the category page exists.

Parameters[edit | edit source]

  • acfrom: The category to start enumerating from
  • acto: The category to stop enumerating at
  • acprefix: Search for all category titles that begin with this value
  • acdir: Direction to sort in (Default: ascending)
    • ascending: List from A to Z
    • descending: List from Z to A
  • acmin: Minimum number of category members
  • acmax: Maximum number of category members
  • aclimit: How many categories to return. No more than 500 (5000 for bots) allowed. (Default: 10)
  • acprop: Which properties to get (Default: none)
    • size: Adds number of pages in the category
    • hidden: Tags categories that are hidden with __HIDDENCAT__

Example[edit | edit source]

List the first 10 categories whose name starts with "List of"

Error Codes[edit | edit source]

None

Allimages[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.13

Returns a list of all images, ordered by image title or by timestamp. Timestamp order was added in MediaWiki 1.20. Only the most recent version of each image is returned.

Parameters[edit | edit source]

  • aisort: Property to sort by (Default: name) 1.20+
    • name: Sort results by name
    • timestamp: Sort results by timestamp
  • aidir: In which direction to list (Default: ascending)
    • ascending: List from A to Z (when aisort=name) or from old to new (when aisort=timestamp)
    • descending: List from Z to A (when aisort=name) or from new to old (when aisort=timestamp)
    • newer: List from A to Z (when aisort=name) or from old to new (when aisort=timestamp) 1.20+
    • older: List from Z to A (when aisort=name) or from new to old (when aisort=timestamp) 1.20+
  • aifrom: Start listing at this title. The title doesn't need to exist. Can only be used with aisort=name
  • aito: Stop listing at this title. The title doesn't need to exist. Can only be used with aisort=name
  • aiprefix: Only list titles that start with this value. Can only be used with aisort=name
  • aistart: The timestamp to start enumerating from. Can only be used with aisort=timestamp 1.20+
  • aiend: The timestamp to end enumerating. Can only be used with aisort=timestamp 1.20+
  • aiminsize: Only list images that are at least this many bytes in size
  • aimaxsize: Only list images that are at most this many bytes in size
  • ailimit: Maximum amount of images to list (Default: 10)
  • aisha1: Only list images with this SHA-1 hash. These hashes are supposed to be unique, so you can use this to track duplicates. If you run into two different images with the same hash, you should start playing the lottery
  • aisha1base36: Same as aisha1, but in base 36
  • aiuser: Only return files uploaded by this user. Can only be used with aisort=timestamp. Cannot be used together with aifilterbots 1.20+
  • aifilterbots: How to filter files uploaded by bots. Can only be used with aisort=timestamp. Cannot be used together with aiuser. Possible values: all, bots, nobots. 1.20+
  • aiprop: Which properties to get (Default: timestamp|url)
    • timestamp: The time and date the most recent version of the image was uploaded
    • user: The name of the user who uploaded the most recent version
    • userid: Add the user ID that uploaded the image version 1.17+
    • comment: The edit comment for the latest upload
    • parsedcomment: Parse the comment on the version 1.17+
    • canonicaltitle: Adds the canonical title of the image file 1.23+
    • url: The URL to the most recent version of the image
    • size: The image's size in bytes, its height and its width. Page count and duration are added if applicable
    • dimensions: Alias for size
    • sha1: The image's SHA-1 hash
    • mime: The image's MIME type
    • mediatype: The media type of the image 1.18+
    • metadata: Exif metadata for the version of the image
    • commonmetadata: File format generic metadata for the version of the image 1.23+
    • extmetadata: Formatted metadata combined from multiple sources. Results are HTML formatted. 1.23+
    • bitdepth: The bit depth of the version 1.14+
  • aimime: What MIME type to search for. e.g. image/jpeg. Disabled in Miser Mode 1.18+

Example[edit | edit source]

Show a list of first 5 images whose name starts with "Albert"

Alllinks[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.11

Returns a list of (unique) links to pages in a given namespace starting ordered by link title.

Parameters[edit | edit source]

  • alcontinue: Used to continue a previous request
  • alfrom: Start listing at this title. The title need not exist.
  • alprefix: Only list links to titles that begin with this value
  • alnamespace: The namespace to enumerate. You can only enumerate one namespace at a time. By default, the main namespace will be enumerated.
  • alunique: If set, multiple links to the same title will be listed only once. It cannot be used with alprop=ids. When used as a generator, yields target pages instead of source pages. Before MW 1.21 (gerrit:40559) it couldn't be used in generator mode.
  • allimit: Maximum amount of links to list. (Default: 10)
  • alprop: Which properties to return. (Default: title)
    • ids: Page IDs of the linking pages. Cannot be used together with alunique.
    • title: Link titles

Example[edit | edit source]

List all links to talk pages whose name starts with Talk:API

Error Codes[edit | edit source]

Code Info
alparams alllinks cannot be used as a generator in unique links mode
alparams alllinks cannot return corresponding page ids in unique links mode
Note: This happens when you use alunique and alprop=ids together
alparams alcontinue and alfrom cannot be used together

Allpages[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.8

Returns a list of pages in a given namespace, ordered by page title.

  • apfrom: Start listing at this title. The title need not exist.
  • apto: The page title to stop enumerating at
  • apprefix: Only list titles that start with this value
  • apnamespace: The id of the namespace to enumerate (see API:Meta to get the list and the ids of the namespaces). You can only enumerate one namespace at a time. (Default: 0)
  • apfilterredir: How to filter redirects (Default: all)
    • all: List all pages regardless of their redirect flag
    • redirects: Only list redirects
    • nonredirects: Don't list redirects
  • apfilterlanglinks: How to filter based on whether a page has language links (Default: all)
    • all: List all pages regardless of whether they have language links
    • withlanglinks: Only list pages with language links
    • withoutlanglinks: Only list pages without language links
  • apminsize: Only list pages that are at least this many bytes in size
  • apmaxsize: Only list pages that are at most this many bytes in size
  • apprtype: Only list pages that have been protected from this type of action
    • edit: Only list edit-protected pages
    • move: Only list move-protected pages
  • apprlevel: Only list pages that have been protected at this level. Cannot be used without apprtype
    • autoconfirmed: Only autoconfirmed users can edit/move/whatever
    • sysop: Only sysops can edit/move/whatever
  • aplimit: Maximum amount of pages to list. (Default: 10)
  • apdir: In which direction to list (Default: ascending)
    • ascending: List from A to Z
    • descending: List from Z to A
  • apprfiltercascade: Filter protections based on cascadingness (ignored when apprtype isn't set). Possible values: cascading, non-cascading, all. (Default: all)
  • prexpiry: Which protection expiry to filter the page on (Default: all)
    • 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

Example[edit | edit source]

Show a list of first 5 pages starting from "Kre"

Show a list of first 3 categories (Namespace id = 14) starting at Ab...

Error Codes[edit | edit source]

  • Unrecognized parameter
    • info: when using allpages as a generator instead of just a list, add a g to the start of its parameter names. E.g. "gapnamespace" instead of "apnamespace"
  • code: apparams
    • info: Use "gapfilterredir=nonredirects" option instead of "redirects" when using allpages as a generator
  • code: apparams
    • info: prlevel may not be used without prtype

See also[edit | edit source]

Alltransclusions[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.21

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

This module is part of API:Alllinks.

Added in gerrit:40559.

Parameters[edit | edit source]

  • 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 transclusion titles that begin with this value.
  • atunique: Only show distinct transclusion titles. Cannot be used with atprop=ids. When used as a generator, yields target pages instead of source pages.
  • atprop: What pieces of information to include. (Default: title)
    • title: Adds the title of the transclusion
    • ids: Adds the pageid of the transcluding page. (Cannot be used with atunique).
  • atnamespace: The namespace number to enumerate. (Default: 10 (the Template: namespace))
  • atlimit: How many total items to return. (Default: 10)
  • atdir: The direction in which to list (Default: ascending)
    • ascending: List from A to Z.
    • descending: List from Z to A.

Example[edit | edit source]

To count the number of pages which transclude a template, to decide to protect it above a certain number.

List all links to talk pages whose name starts with Talk:API

Allusers[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.11

Parameters[edit | edit source]

  • from : The user name to start enumerating from
  • to : The user name to stop enumerating at
  • prefix : Search for all users that begin with this value
  • dir : Direction to sort in. One value: ascending, descending. Default: ascending
  • group : Limit users to given group name(s). Possible values: bot, sysop, bureaucrat (+ any other group that is defined on the wiki). This is different for every wiki; see the API help or action=paraminfo for a list of possible values.
  • excludegroup : Exclude users in given group name(s)
  • rights : Limit users to given right(s)
  • prop : What 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)
  • limit : How many total user names to return. No more than 500 (5000 for bots) allowed. (Default: 10)
  • witheditsonly: Only list users who have made edits
  • activeusers : Only list users active in the last 30 days(s)

Example[edit | edit source]

Show a list of usernames starting with Y (or whichever sorts first after that)

Show a list of first 5 sysops

Error Codes[edit | edit source]

None

Backlinks[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.9

Lists pages that link to a given page, similar to Special:Whatlinkshere. Ordered by linking page title.

Parameters[edit | edit source]

  • bltitle: List pages linking to this title. The title does not need to exist.
  • blnamespace: Only list pages in these namespaces
  • blfilterredir: How to filter redirects (Default: all)
    • all: List all pages regardless of their redirect flag
    • redirects: Only list redirects
    • nonredirects: Don't list redirects
  • bllimit: Maximum amount of pages to list. Maximum limit is halved if blredirect is set. No more than 500 (5000 for bots) allowed. (Default: 10)
  • blredirect: If set, pages linking to bltitle through a redirect will also be listed. See below for more detailed information.
  • blcontinue: Used to continue a previous request

Example[edit | edit source]

Find all pages that redirect to en:Main Page.

Other links[edit | edit source]

Links through redirects[edit | edit source]

MediaWiki version: 1.12

When the blredirect parameter is set, this module behaves slightly differently. bllimit applies to both levels separately: if e.g. bllimit=10, at most 10 first-level pages (pages that link to bltitle) and 10 second-level pages (pages that link to bltitle through a redirect) will be listed. Continuing queries also works differently, as displayed in the following example.

Get a list of pages linking to Albert Einstein (note: the initial query includes a "blcontinue" parameter for purposes of illustration)

When continuing this request, we see that there are more pages linking to Einstein, and that some of the other first-level pages are listed again. If we continue this query again, the same first-level pages will be listed in the next response, as well. To progress beyond Energy, we have to query-continue again and again until we've had all links to Einstein (or increase bllimit, of course). Continuing the previous request:

Links through transclusions[edit | edit source]

If you need to list pages as they appear in "What links here" on the MediaWiki sites with pages transcluding the desired page, you might want to try API:Embeddedin list.

Links through image usage[edit | edit source]

If you need to list pages as they appear in "What links here" on the MediaWiki sites with pages displaying the desired file, you might want to try API:Imageusage list. This also works on non-existent files.

Error Codes[edit | edit source]

Code Info
blbadcontinue Invalid continue param. You should pass the original value returned by the previous query.

Blocks[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.12

List all blocks, à la Special:Ipblocklist. This module cannot be used as a generator.

Parameters[edit | edit source]

  • bkstart: The timestamp to start listing from
  • bkend: The timestamp to end listing at
  • bkdir: Direction to list in. (Default: older)
    • older: List newest blocks first. Note: bkstart has to be later than bkend.
    • newer: List oldest blocks first. Note: bkstart has to be before bkend.
  • bkids: Only list blocks with these IDs
  • bkusers: Only list blocks of these users
  • bkip: List all blocks, including range blocks, that apply to this IP address. You can also specify a CIDR range here, in which case only blocks applying to the entire range will be listed. Cannot be used together with bkusers. CIDR ranges broader than /16 are not allowed, as range blocks cannot cross /16 boundaries
  • bklimit: Maximum number of blocks to list (Default: 10)
  • bkprop: A pipe-separated list of properties to get. They appear as keys of returned dictionary. (Default: id|user)
    • id: The ID of the block
    • user: The IP address or username that was blocked (does not appear in output for autoblocks)
    • userid: The id of user who was blocked (does not appear in output for autoblocks)
    • by: The user who applied the block
    • byid: The id of user who applied the block
    • timestamp: When the block was applied
    • expiry: When the block will expire
    • reason: The reason for the block
    • range: If an IP range was blocked, the first and last IP the block applies to
      Will appear as rangestart and rangeend in the answer, both 0.0.0.0 for registered users. Same as user for standalone IPs.
    • flags: Flags that apply to the block
      The appropriate flags will appear as keys of returned dictionary with an empty value. No key if the flag is not valid for the block.
      • automatic: Automatically blocked because of an autoblock (see also action=block)
      • anononly: Only anonymous edits are blocked
      • nocreate: Account creation is disabled
      • autoblock: Automatic blocking is enabled for this block
      • noemail: Sending e-mail through the wiki is disabled for the blocked user
      • allowusertalk: The user is allowed to edit his/her own talk page
      • hidden: This block is hidden from Special:Ipblocklist. Only users with oversight permissions can see these blocks.

Example[edit | edit source]

Listing the 3 most recent blocks

Error Codes[edit | edit source]

None.

See also[edit | edit source]

Categorymembers[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e


MediaWiki version: 1.11

List of pages that belong to a given category, ordered by page sort title.

Parameters[edit | edit source]

  • cmtitle: The category to enumerate (required unless cmpageid is used). Must include "Category:" prefix. Cannot be used together with cmpageid.
  • cmpageid: Page ID of the category to enumerate. Cannot be used together with cmtitle.
  • cmnamespace: Only list pages in these namespaces
  • cmtype: Type of category members to include. Ignored when cmsort=timestamp is set. Possible values: page, subcat, file. (Default: page|subcat|file)
  • cmstart: Start listing at this timestamp. Can only be used with cmsort=timestamp 1.12+
  • cmend: End listing at this timestamp. Can only be used with cmsort=timestamp 1.12+
  • cmstarthexsortkey: Start listing at this hexadecimal sortkey. Can only be used with cmsort=sortkey. 1.24+
  • cmendhexsortkey: End listing at this hexadecimal sortkey. Can only be used with cmsort=sortkey. 1.24+
  • cmstartsortkeyprefix: Start listing at this sortkey prefix. Can only be used with cmsort=sortkey. Overrides cmstarthexsortkey. 1.18+
  • cmendsortkeyprefix: End listing before (not at) this sortkey prefix (if this value occurs it will not be included). Can only be used with cmsort=sortkey. Overrides cmendhexsortkey. 1.18+
  • cmsort: Property to sort by (Default: sortkey)
    • sortkey: The article's sort key. The sort key might contain "unprintable" characters such as newlines, NULs, ASCII control characters, and so on. When returned from the API using cmprop=sortkey, the whole sortkey is encoded by converting the UTF-8 to a string of hex digits.
    • timestamp: The time the article was added to the category (or the categorization, i.e. the sortkey, was changed)
  • cmdir: Direction to sort in. (Default: asc) 1.12+
    • asc: From A to Z or from 2002 to 2014. As of MW 1.20, ascending and newer are synonymous with asc. Note: cmstart has to be before cmend.
    • desc: From Z to A or from 2014 to 2002. As of MW 1.20, descending and older are synonymous with desc. Note: cmstart has to be later than cmend.
  • cmlimit: Maximum number of pages to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • cmprop: Which properties to get. (Default: ids|title)
    • ids: Page ID
    • title: Page title
    • sortkey: The sortkey used for sorting in the category (hexadecimal string)
    • sortkeyprefix: The sortkey prefix used for sorting in the category (human-readable part of the sortkey) 1.17+
    • type: Type that the page has been categorised as (page, subcat or file) 1.17+
    • timestamp: Time and date the article was added to the category
  • cmcontinue: Used to continue a previous request.
  • cmstartsortkey: Like cmstarthexsortkey, but the value is passed as a binary string rather than the hex-encoded value returned from cmprop=sortkey. 1.14+ (deprecated in 1.24)
  • cmendsortkey: Like cmendhexsortkey, but the value is passed as a binary string rather than the hex-encoded value returned from cmprop=sortkey. 1.14+ (deprecated in 1.24)

Example[edit | edit source]

Standard syntax: list 10 pages in a category (e.g. Category:Physics)

List 20 items in the Category:Physics, it will list its 11 pages, and 9 subcategories

Get the 10 articles most recently added to Category:Physics

Get the 10 subcategories of Category:Wikipedia

Continue the next subcategories (if there's more than 10) in Category:Wikipedia (the "cmcontinue" parameter is from the result above)

If you're using "cmcontinue" parameter for pages, the "cmtype=page" parameter is optional, but for subcategories (or files), the "cmtype=subcat" (or "cmtype=file") is necessary.

Error Codes[edit | edit source]

Code Info
cmnotitle The cmtitle parameter is required
cminvalidcategory The category name you entered is not valid
cmbadcontinue Invalid continue param. You should pass the original value returned by the previous query

deletedrevs[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.12
NOTE: This module's behavior was changed significantly in MediaWiki 1.15. Some of the features described here are not available in MediaWiki 1.14 and earlier.

List deleted revisions. You need the deletedhistory right to use this module. This module cannot be used as a generator. This module can be used in one of three modes:

  1. List deleted revisions for the given titles (through titles or a generator), sorted by timestamp
  2. List deleted contributions for a certain user, sorted by timestamp (druser set, no titles given)
  3. List all deleted revisions in a certain namespace (druser not set, no titles given)

Some parameters are restricted to certain modes only, and are marked accordingly.

Parameters[edit | edit source]

  • drlimit: Maximum number of revisions to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • druser: Only list revisions by this user 1.15+
  • drexcludeuser: Don't list revisions by this user 1.15+
  • drstart: The timestamp to start listing from. If not specified, all revisions earlier than drend will be listed.[1]
  • drend: The timestamp to end listing at. If not specified, all revisions later than drstart will be listed.[1]
  • drdir: Direction to list in.[1] (Default: older)
    • older: List newest revisions first. Note: drstart has to be later than drend.
    • newer: List oldest revisions first. Note: drstart has to be earlier than drend.
  • drnamespace: List all deleted revisions in this namespace.[2] (Note that namespace was included in the original 1.12 as a pipe-separated list of values, but was removed in 1.13. In 1.15, it was reintroduced as a single-valued parameter.) 1.15+
  • drunique: List only one revision for each page[2] 1.15+
  • drfrom: Start listing at this title[2] 1.15+
  • drto: Stop listing at this title[2] 1.18+
  • drprefix: Search for all page titles that begin with this value[2] 1.18+
  • drcontinue: When more results are available, use this to continue. Note: prior to MW 1.23, drstart was used as a continue in mode 2 rather than drcontinue.
  • drprop: Which properties to get (Default: user|comment)
    • revid: Revision ID
    • parentid: Revision ID of the previous revision to the page 1.18+
    • user: User who made the revision
    • userid: User ID who made the revision 1.17+
    • comment: Edit comment
    • parsedcomment: Parsed comment of the revision 1.16+
    • minor: Whether the revision was minor
    • len: Revision size
    • content: Revision content. You need the undelete or deletedtext right to use this option
    • token: Undelete token (deprecated in 1.24)
    • sha1: SHA-1 (base 16) of the revision 1.19+
    • tags: Tags for the revision 1.23+
  • drtag: Only list revisions tagged with this tag 1.23+
  1. 1.0 1.1 1.2 Modes 1 and 2 only
  2. 2.0 2.1 2.2 2.3 2.4 Mode 3 only

Examples[edit | edit source]

Listing the 6 most recent deleted revisions from user Catrope dated September 4, 2007 (mode 2).

Error Codes[edit | edit source]

Code Info
drpermissiondenied You don't have permission to view deleted revision information. On most wikis, viewing deleted revisions is restricted to sysops, but other wikis may have different rules.
drpermissiondenied You don't have permission to view deleted revision content.

Embeddedin[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.11

List pages that transclude a certain page.

Parameters[edit | edit source]

  • eititle: List pages including this title. The title need not exist
  • einamespace: Only list pages in these namespaces
  • eifilterredir: How to filter redirects (Default: all)
    • all: List all pages regardless of their redirect flag
    • redirects: Only list redirects
    • nonredirects: Don't list redirects
  • eilimit: Maximum amount of pages to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • eicontinue: Used to continue a previous request

Example[edit | edit source]

Find all pages that embed en:template:Stub.

Error Codes[edit | edit source]

Code Info
eibadcontinue Invalid continue param. You should pass the original value returned by the previous query.

Exturlusage[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.11

Get a list of pages that link to a certain URL, à la Special:Linksearch

Parameters[edit | edit source]

  • euprop: Which properties to get (Default: ids|title|url)
    • ids: Page ID of the linking page
    • title: Title of the linking page
    • url: URL being linked to
  • euoffset: Used for continuing a previous request
  • euprotocol: Protocol of the URL. Possible values: listed in $wgUrlProtocols. (Default: http)
  • euquery: The URL to search for, without the protocol. * can be used as a wildcard. If omitted, all external links will be listed, filtered by euprotocol, if provided. MediaWiki versions 1.11 and 1.12 abort if euquery is omitted.
  • eunamespace: Only list links from pages in these namespaces
  • eulimit: Maximum amount of pages to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • euexpandurl: Expand protocol-relative URLs with the canonical protocol 1.21+

Example[edit | edit source]

Get a list of pages linking to slashdot.org

Filearchive[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e


MediaWiki version: 1.17
  • Prefix: fa
  • Required Rights: None
  • POST Only? No

Enumerate all deleted files sequentially

Parameters[edit | edit source]

  • fafrom: The image title to start enumerating from
  • facontinue: When more results are available, use this to continue 1.20+
  • fato: The image title to stop enumerating at 1.18+
  • faprefix: Search for all image titles that begin with this value
  • fadir: The direction in which to list Possible values: ascending, descending. (Default: ascending)
  • falimit: How many images to return in total No more than 500 (5000 for bots) allowed. (Default: 10)
  • fasha1: SHA1 hash of image. Overrides fasha1base36 1.18+
  • fasha1base36: SHA1 hash of image in base 36 (used in MediaWiki) 1.18+
  • faprop: What image information to get. (Default: timestamp)
    • sha1: Adds SHA-1 hash for the image
    • timestamp: Adds timestamp for the uploaded version
    • user: Adds user who uploaded the image version
    • size: Adds the size of the image in bytes and the height, width and page count (if applicable)
    • dimensions: Alias for size
    • description: Adds description the image version
    • parseddescription: Parse the description on the version 1.18+
    • mime: Adds MIME of the image
    • mediatype: Adds the media type of the image 1.20+
    • metadata: Lists Exif metadata for the version of the image
    • bitdepth: Adds the bit depth of the version
    • archivename: Adds the file name of the archive version for non-latest versions 1.20+

Error Codes[edit | edit source]

Code Info
permissiondenied You don't have permission to view deleted file information.

Imageusage[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.9
  • Prefix: iu
  • Required Rights: None
  • POST Only? No

Find all pages that use the given image title. (Note: In MW 1.9 and 1.10, the module name was imagelinks.)

Parameters[edit | edit source]

  • iutitle: List pages linking to this title. The title does not need to exist.
  • iunamespace: Only list pages in these namespaces
  • iufilterredir: How to filter redirects (Default: all)
    • all: List all pages regardless of their redirect flag
    • redirects: Only list redirects
    • nonredirects: Don't list redirects
  • iulimit: Maximum amount of pages to list. Maximum limit is halved if iuredirect is set. No more than 500 (5000 for bots) allowed. (Default: 10)
  • iuredirect: If set, pages linking to iutitle through a redirect will also be listed. See below for more detailed information.
  • iucontinue: Used to continue a previous request

Errors Codes[edit | edit source]

Code Info
iubadcontinue Invalid continue param. You should pass the original value returned by the previous query.

Iwbacklinks[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.17
  • Prefix: iwbl
  • Required Rights: None
  • POST Only? No

Find all pages that link to the given interwiki link. Can be used to find all links with a prefix, or all links to a title (with a given prefix). Using neither parameter is effectively "All IW Links".

Parameters[edit | edit source]

  • iwblprefix: Prefix for the interwiki. Type: string
  • iwbltitle: Interwiki link to search for. Must be used with iwblprefix. Type: string
  • iwblcontinue: When more results are available, use this to continue. Type: string
  • iwbllimit: How many total pages to return. No more than 500 (5000 for bots) allowed. Type: limit (Default: 10)
  • iwblprop: Which properties to get (Default: none)
    • iwprefix: Adds the prefix of the interwiki
    • iwtitle: Adds the title of the interwiki. Possible values: iwprefix, iwtitle.
  • iwbldir: The direction in which to list Possible values: ascending, descending. (Default: ascending) 1.20+

Error Codes[edit | edit source]

Code Info
missingparam The prefix parameter must be set.

Langbacklinks[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.18
  • Prefix: lbl
  • Required Rights: None
  • POST Only? No

Find all pages that link to the given language link. Can be used to find all links with a language code, or all links to a title (with a given language). Using neither parameter is effectively "All Language Links".

Parameters[edit | edit source]

  • lbllang: Language for the language link. Type: string
  • lbltitle: Language link to search for. Must be used with lbllang Type: string
  • lblcontinue: When more results are available, use this to continue. Type: string
  • lbllimit: How many total pages to return. No more than 500 (5000 for bots) allowed. Type: limit (Default: 10)
  • lblprop: Which properties to get. (Default: none)
    • lllang: Adds the language code of the language link.
    • lltitle: Adds the title of the language link.
  • dir: The direction in which to list. Type: string 1.20+

Errors Codes[edit | edit source]

Code Info
missingparam The lang parameter must be set.

Logevents[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.9

Get a list of all logged events, à la Special:Log. This module cannot be used as a generator.

Parameters[edit | edit source]

  • leprop: Which properties to get. (Default: ids|title|type|user|timestamp|comment|details)
    • ids: Page ID of the page in question and log ID
    • title: Title of the page in question
    • type: Type of log entry
    • user: User responsible for the log entry
    • userid: The user ID who was responsible for the log event. When specified for account creation events, the userid of the creating user is returned. When absent, the userid returned is that of the created account (see bugzilla:71020).
    • timestamp: Time and date the log entry was created
    • comment: Log comment
    • parsedcomment: The parsed comment of the event
    • details: Extra information (not present for all log types)
    • tags: List tags for the event
  • letype: Only list log entries of this type. Note that extensions may add other log types.
    • block
    • delete
    • import
    • merge
    • move
    • newusers
    • patrol
    • protect
    • rights
    • upload
  • leaction: Filter log actions to only this type. Overrides letype even if the action isn't related to letype.
    • block/block
    • block/reblock
    • block/unblock
    • delete/delete
    • delete/event
    • delete/restore
    • delete/revision
    • import/interwiki
    • import/upload
    • merge/merge
    • move/move_redir
    • move/move
    • newusers/autocreate
    • newusers/create2
    • newusers/create
    • newusers/newusers
    • patrol/patrol
    • protect/modify
    • protect/move_prot
    • protect/protect
    • protect/unprotect
    • rights/autopromote
    • rights/erevoke
    • rights/rights
    • upload/overwrite
    • upload/revert
    • upload/upload
  • leuser: Only list log entries made by this user
  • letitle: Only list log entries related to this title
  • lestart: The timestamp to start listing from
  • leend: The timestamp to end listing at
  • ledir: Direction to list in. (Default: older)
    • older: List newest log entries first. Note: lestart has to be later than leend.
    • newer: List oldest log entries first. Note: lestart has to be earlier than leend.
  • lelimit: Maximum number of log entries to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • leprefix: Filter entries that start with this prefix. Disabled in Miser Mode
  • letag: Only list event entries tagged with this tag

Example[edit | edit source]

List the 3 most recent page moves

Error Codes[edit | edit source]

Code Info
leparam_user User name username not found
leparam_title Bad title value 'title'
This happens when you set letitle to an invalid title.

Notes[edit | edit source]

For autoblock unblock entries, the page title is shown as "User:$blockid". This is indeed not a User page, just the way it is stored. As per bug 17781

Child elements[edit | edit source]

Here are some examples of child elements that reveal log parameters:

Block

<block flags="nocreate" duration="3 days" expiry="2014-09-18T20:35:54Z" />

Move

<move new_ns="0" new_title="Foo" suppressredirect="" />

Patrol

<patrol cur="12" prev="0" auto="1" />

Rights

<rights new="sysop" old="" />

See also[edit | edit source]

Log events Events: BlockingImportingMerging historiesPage deletionPage movingPage restorationPatrollingProtectionRenaming a userRevision deletionThankingUploadingUser creationUser rights management
Miscellaneous: APIlogging tableNull revision

Protectedtitles[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.15

Get a list of titles protected from creation.

Parameters[edit | edit source]

  • ptnamespace: Only list titles in these namespaces Type: namespace (pipe-separated)
  • ptlevel: Only list titles with this protection level Type: string (pipe-separated)
  • ptlimit: Maximum number of titles to return No more than 500 (5000 for bots) allowed. (Default: 10)
  • ptdir: Direction to list in. (Default: older)
    • older: List most recently protected titles first. Note: ptstart must be later than ptend.
    • newer: List least recently protected titles first. Note: ptstart must be earlier than ptend.
  • ptstart: Start listing at this protection timestamp
  • ptend: End listing at this protection timestamp
  • ptprop: A pipe-separated list of properties to get. (Default: timestamp|level)
    • timestamp: Timestamp the title was protected
    • user: User who protected the title
    • userid: User id who protected the title 1.17+
    • comment: Protection log comment
    • parsedcomment: Parsed protection log comment 1.16+
    • expiry: Expiry timestamp
    • level: Protection level (i.e. the right needed to be able to create the page)
  • continue: When more results are available, use this to continue 1.23+

Example[edit | edit source]

Get the first 2 titles only sysops can create

Error Codes[edit | edit source]

None

Querypage[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e


MediaWiki version: 1.18

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

Parameters[edit | edit source]

  • qppage: The name of the special page. Note, this is case sensitive. Possible values are:
    Ancientpages, BrokenRedirects, Deadendpages, Disambiguations, DoubleRedirects, Listredirects, Lonelypages, Longpages, Mostcategories, Mostimages, Mostlinkedcategories, Mostlinkedtemplates, Mostlinked, Mostrevisions, Fewestrevisions, Shortpages, Uncategorizedcategories, Uncategorizedpages, Uncategorizedimages, Uncategorizedtemplates, Unusedcategories, Unusedimages, Wantedcategories, Wantedfiles, Wantedpages, Wantedtemplates, Unwatchedpages, Unusedtemplates, Withoutinterwiki
  • qpoffset: When more results are available, use this to continue.
  • qplimit: Number of results to return.

Example[edit | edit source]

Show a list of first 10 pages which are uncategorized.

Random[edit | edit source]

random / rn[edit | edit source]

MediaWiki version: 1.12

Get a list of random pages.

Pages are listed in a fixed sequence, only the starting point is random. This means that if, for example, "Main Page" is the first random page on your list, "List of fictional monkeys" will always be second, "List of people on stamps of Vanuatu" third, etc.

Parameters

  • rnlimit: Maximum number of pages to return (1 by default)
    • If the number of pages in the namespace is lower than rnlimit, you will get fewer pages. You will not get the same page twice.
  • rnnamespace: Only list pages in these namespaces
  • rnredirect: Only list redirects
    • By default, only non-redirects are listed

Example

Get 5 random pages

Possible errors

None

Recentchanges[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.9

Get all recent changes to the wiki, à la Special:Recentchanges. This module can be used as a generator (but note that, like all other generators, it generates information about pages, not about revisions). Apparently, although many log actions can be viewed using this module, patrol actions are not among them. This module is implemented by ApiQueryRecentChanges.php.

Parameters[edit | edit source]

  • rcstart: The timestamp to start listing from (May not be more than $wgRCMaxAge into the past, which on Wikimedia wikis is 30 days[1])
  • rcend: The timestamp to end listing at
  • rcdir: Direction to list in (Default: older)
    • older: List newest changes first. Note: rcstart has to be later than rcend.
    • newer: List oldest changes first. Note: rcstart has to be before rcend.
  • rcnamespace: Only list changes in these namespaces
  • rcuser: Only list changes made by this user
  • rcexcludeuser: Do not list changes made by this user
  • rctag: Only list changes tagged with this tag
  • rctype: Only list certain types of changes
    • edit: Regular page edits
    • external: External edits
    • new: Page creations (Uploads are not listed as new but as log)
    • log: Log entries
  • rcshow: Only list items that meet these criteria. Conflicting options (such as minor and !minor) cannot be used together
    • minor: Only list minor edits
    • !minor: Don't list minor edits
    • bot: Only list bot edits
    • !bot: Don't list bot edits
    • anon: Only list edits by anonymous users
    • !anon: Only list edits by registered users
    • redirect: Only list edits to pages that are currently redirects
    • !redirect: Only list edits to pages that currently aren't redirects
    • patrolled: Only list edits flagged as patrolled. Only available to users with the patrol right
    • !patrolled: Only list edits not flagged as patrolled. Only available to users with the patrol right
  • rcprop: Which properties to get (Default: timestamp|title|ids)
    • user: The user who made the change. Also returns anon="" if it was an anonymous edit.
    • userid: The user id who made the change.
    • comment: The edit/log comment
    • parsedcomment: The parsed comment for the edit/log comment
    • timestamp: The time and date of the change
    • title: The title the change was made to
    • ids: Gets the following IDs: pageid (rc_cur_id); rcid (rc_this_oldid); old_revid (rc_last_oldid); and rcid (rc_id) (used for patrolling).
    • sha1: content checksum for entries associated with a revision
    • sizes: The page size before (oldlen) and after (newlen) the change
    • redirect: Whether the changed page is currently a redirect. When returned, the value is an empty string; not the redirect destination.
    • patrolled: Whether the change is patrolled. Only available to users with the patrol right. When returned, the value is an empty string.
    • loginfo: If the change was a log event, add the logid, logtype and logaction fields and the log parameters 1.13+
    • tags: List tags for the entry
    • flags
      • new: A new page was created
      • minor: The change was a minor edit
      • bot: The change was a bot edit
  • rctoken: Which tokens to obtain for each change
  • rclimit: Maximum amount of changes to list (Default: 10)
  • rctoponly: Only list changes which are the latest revision
  • rccontinue: When more results are available, use this to continue
  • rctitles: Restrict results to these page titles 1.14+ (removed in 1.15)

Example[edit | edit source]

Get the 3 most recent changes with sizes and flags

Possible warnings

  • Action 'action' is not allowed for the current user
    • Thrown when a token is requested that the current user isn't allowed to use

Error Codes[edit | edit source]

  • code: rcshow
    • info: Incorrect parameter - mutually exclusive values may not be supplied
  • code: rcpermissiondenied
    • info: You need the patrol right to request the patrolled flag

Output[edit | edit source]

The "type" that is returned can be 'edit', 'new', 'move', 'log', 'external', or 'move over redirect'.

See also[edit | edit source]

References[edit | edit source]

  1. https://github.com/wikimedia/operations-mediawiki-config/blob/30e0912531200293145ff4bb1fb044a8d9a4cb6d/wmf-config/CommonSettings.php#L327

Search[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.11

Parameters[edit | edit source]

  • srinfo : What metadata to return. Possible values: totalhits, suggestion. (Default: totalhits|suggestion)
  • srlimit : How many total pages to return. No more than 50 (500 for bots) allowed. (Default: 10)
  • srnamespace: The namespace(s) to enumerate. No more than 50 (500 for bots) allowed. (Default: 0)
  • sroffset : Use this value to continue paging (returned by query).
  • srbackend : Class name of search backend to use (Default: $wgSearchType)
  • srprop : What properties to return. Possible values: size, wordcount, timestamp, score, snippet, titlesnippet, redirecttitle, redirectsnippet, sectiontitle, sectionsnippet, hasrelated. (Default: size|wordcount|timestamp|snippet)
    • size : Adds the size of the page in bytes
    • wordcount : Adds the word count of the page
    • timestamp : Adds the timestamp of when the page was last edited
    • score : Adds the score (if any) from the search engine
    • snippet : Adds a parsed snippet of the page
    • titlesnippet : Adds a parsed snippet of the page title
    • redirectsnippet: Adds a parsed snippet of the redirect
    • redirecttitle : Adds a parsed snippet of the redirect title
    • sectionsnippet : Adds a parsed snippet of the matching section
    • sectiontitle : Adds a parsed snippet of the matching section title
    • hasrelated : Indicates whether a related search is available
  • redirects : Include redirect pages in the search. From 1.23 onwards, redirects are always included. (removed in 1.23)
  • srsearch : Search for all page titles (or content) that has this value.
  • srwhat: Search inside the text or titles. (Default: title (if search engine doesn't support title searches, such as Lucene which is used by Wikipedia, then srwhat=title falls back to text))
    • title : Search in page titles
    • text : Search in page text
    • nearmatch: Search for the exact title
Depending on which search backend is in use, how srsearch is interpreted may vary. On Wikimedia wikis which use Lucene search, see w:Help:Searching#Search_engine_features for information about the search syntax.

Error Codes[edit | edit source]

Result Meaning
nosearch The search parameter must be set.
This was param-search before 1.17
search-text-disabled text search is disabled.
search-title-disabled title search is disabled.
search-error search error has occurred.

Example[edit | edit source]

Show a list of 10 pages that contain the word 'wikipedia'

See also[edit | edit source]

Tags[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.16
  • Prefix: tg
  • Required Rights: None
  • POST Only? No

List valid change tags.

Parameters[edit | edit source]

  • continue – When more results are available, use this to continue.
  • limit – The maximum number of tags to list. Type: limit
  • prop – Which properties to get name - Adds name of tag displayname - Adds system message for the tag description - Adds description of the tag hitcount - Adds the amount of revisions that have this tag.
Type: one of name, displayname, description, hitcount

Errors Codes[edit | edit source]

  • invalidtitle – Bad title ``key''.
  • invalidtitle – Bad title ``title''.
  • readapidenied – You need read permission to use this module.

Usercontribs[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.9

Gets a list of contributions made by a given user, ordered by modification time. This module cannot be used as a generator.

Parameters[edit | edit source]

  • ucuser: Users to retrieve contributions for
  • ucuserprefix: List contributions of all users whose name starts with this string. Overrides ucuser
    • This is useful for getting contributions of IP ranges.
    • Note that contributions will be sorted by user first, then by timestamp, when using this option
  • ucstart: The timestamp to start listing from (see API:Data formats#Timestamps)
  • ucend: The timestamp to end listing at (see API:Data formats#Timestamps)
  • uccontinue: When more results are available, use this to continue
  • ucdir: Direction to list in
    • older: List newest contributions first (default). Note: ucstart has to be later than ucend.
      • If using ucuserprefix, users will be listed in descending order (Z to A)
    • newer: List oldest contributions first. Note: ucstart has to be before ucend.
      • If using ucuserprefix, users will be listed in ascending order (A to Z)
  • uclimit: Maximum amount of contributions to list (10 by default)
  • ucnamespace: Only list contributions in these namespaces (numeric value)
  • ucshow: Only list contributions that meet these criteria. Conflicting options (such as minor and !minor) cannot be used together
    • minor: Only list minor edits
    • !minor: Don't list minor edits
    • patrolled: Only list patrolled edits. Only available to users with the patrol right
    • !patrolled: Only list non-patrolled edits. Only available to users with the patrol right
    • top: Only list top (latest) edits. (since MediaWiki 1.23)
    • !top: Only list non-top edits. (since MediaWiki 1.23)
    • new: Only list page creations. (since MediaWiki 1.23)
    • !new: Don't list page creations. (since MW 1.23)
      • If patrolled or !patrolled is used, revisions older than $wgRCMaxAge will not be shown.
  • ucprop: Which properties to get
    • ids: Page ID and revision ID. Starting in MediaWiki 1.22 this will also include the parent revision's id.
    • title: Title of the page that was changed
    • timestamp: Time and date of the contribution
    • comment: Edit/log comment
    • parsedcomment: Parsed edit/log comment
    • size: Size of the edit
    • sizediff: Size delta between the edit and its parent
    • patrolled: Whether the change is patrolled. Only available to users with the patrol right
    • flags:
      • new: A new page was created
      • minor: The change was a minor edit
      • bot: The change was a bot edit
      • top: This is the latest version of the article
    • tags: List of tags for the edit
  • uctoponly: Only show top edits (deprecated in favor of ucshow=top in MediaWiki 1.23)

Example[edit | edit source]

Get the first three contributions by en:User:Catrope

Error Codes[edit | edit source]

  • code: ucparam_user
    • info: User name username is not valid
  • code: ucparam_user
    • info: User parameter may not be empty
  • code: ucshow
    • info: Incorrect parameter - mutually exclusive values may not be supplied
  • code: permissiondenied
    • info: You need the patrol right to request the patrolled flag

See also[edit | edit source]

Users[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e


MediaWiki version: 1.12

Get information about a list of users. This module cannot be used as a generator. This module is implemented by ApiQueryUsers.php.

Parameters[edit | edit source]

Example[edit | edit source]

Getting information about a list of users

Error Codes[edit | edit source]

None

Watchlist[edit | edit source]

watchlist / wl[edit | edit source]

MediaWiki version: 1.11

Get a list of pages on the current user's watchlist that were changed within the given time period. Ordered by time of the last change of the watched page.

Parameters

  • wlstart: The timestamp to start listing from
  • wlend: The timestamp to end listing at
  • wldir: Direction to list in
    • older: List most recently changed pages first (default). Note: wlstart has to be later than wlend.
    • newer: List least recently changed pages first. Note: wlstart has to be before wlend.
  • wllimit: Maximum amount of pages to list (10 by default)
  • wlnamespace: Only list pages in these namespaces
  • wluser: Only list changes made by this user
  • wlexcludeuser: Do not list changes made by this user
  • wlowner: The user whose watchlist you want (must be accompanied by wltoken if it's not the currently logged-in user). Remember that using format=json with callback is always in a logged-out environment, meaning wltoken is required even if it's for the supposedly current logged-in user) (New in 1.17. Added in r66539)
  • wltoken: Security token that the wlowner has set in their preferences. (Note: New in 1.17. Added in r66539)
  • wlallrev: Include multiple revisions to the same page. This parameter cannot be used in generator mode
  • wltype: Only list certain types of changes (available from MW1.22wmf4)
    • edit: Regular page edits
    • external: External edits
    • new: Page creations
    • log: Log entries
  • wlshow: Only list revisions that meet these criteria. Conflicting options (such as minor and !minor) cannot be used together
    • minor: Only list minor edits
    • !minor: Don't list minor edits
    • bot: Only list bot edits
    • !bot: Don't list bot edits
    • anon: Only list edits by anonymous users
    • !anon: Only list edits by registered users
  • wlprop: Which properties to get
    • user: The user who made the change
    • comment: The edit/log comment
    • parsedcomment: The edit/log comment in HTML format with wikilinks and section references expanded into hyperlinks (New in 1.16. Added in r61761)
    • timestamp: The time and date of the change
    • notificationtimestamp: Adds timestamp of when the user was last notified about the edit
    • title: The title the change was made to (default)
    • ids: The page ID and revision ID (default)
    • sizes: The page size before and after the change
    • patrol: Whether the change is patrolled. Only available to users with the patrol right
    • flags: (default)
      • new: A new page was created
      • minor: The change was a minor edit
      • bot: The change was a bot edit
      • anon: The change was made by a user who wasn't logged in

Example

Get the current user's watchlist

Possible errors

  • code: wlnotloggedin
    • info: You must be logged-in to have a watchlist
  • code: wlpatrol
    • info: patrol property is not available
  • code: wlshow
    • info: Incorrect parameter - mutually exclusive values may not be supplied


Watchlistraw[edit | edit source]

Tools clipart.png This page is part of the MediaWiki API documentation.
MediaWiki API

Quick overview:

v · d · e
MediaWiki version: 1.14

Returns a list of all pages on the logged in users watchlist.

Parameters[edit | edit source]

  • wrcontinue: Used to continue a previous request
  • wrnamespace: Only list pages in the given namespace(s)
  • wrlimit: How many total results to return per request
  • wrprop: Which additional properties to get (non-generator mode only):
    • changed: Adds timestamp of when the user was last notified about the edit
  • wrshow: Only list items that meet these criteria:
    • changed
    • !changed
  • wrowner: The name of the user whose watchlist you'd like to access
  • wrtoken: Give a security token (settable in preferences) to allow access to another user's watchlist

Example[edit | edit source]

List the first 3 pages on the watchlist from the category namespace

Note: This query module return its result direct under api, not under query like other query modules.

Errors Codes[edit | edit source]

  • bad_wlowner – Specified user does not exist.
  • bad_wltoken – Incorrect watchlist token provided -- please set a correct token in Special:Preferences.
  • invalidtitle – Bad title ``title''.
  • invalidtitle – Bad title ``key''.
  • notloggedin – You must be logged-in to have a watchlist.
  • readapidenied – You need read permission to use this module.
  • show – Incorrect parameter - mutually exclusive values may not be supplied.