API documentation

The following documentation is the output of Special:ApiHelp/query+allcategories, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+allcategories

Example

{
    {
    "batchcomplete": "",
    "continue": {
        "accontinue": "15th-century_churches_in_Denmark",
        "continue": "-||"
    },
    "query": {
        "allcategories": [
            {
                "*": "15th-century caliphs"
            },
            {
                "*": "15th-century calligraphers"
            },
            {
                "*": "15th-century card games"
            },
            ...
        ]
    }
}

Additional notes

• This module differs from list=allpages&alnamespace=14 in that categories without descriptions will be listed, while redirects and pages where the category was never used will not.
• The response may include categories that were previously used but have since been deleted.
• Because the response may include categories that are deleted or otherwise empty, it is recommended to filter the list using acmin=1, so as to only return categories containing one or more members.

See also

• API:Categorymembers - list pages which are members of a certain category.
• API:Categories - a prop module that gets all the categories associated with a particular page.
• API:Allpages - another module that can access the category namespace .

API documentation

The following documentation is the output of Special:ApiHelp/query+allimages, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+allimages

Example

{
    "batchcomplete": "",
    "continue": {
        "aicontinue": "Graffiti_BTER_0001.JPG",
        "continue": "-||"
    },
    "query": {
        "allimages": [
            {
                "name": "Graffiti_0001.JPG",
                "timestamp": "2006-10-26T01:48:05Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/9/98/Graffiti_0001.JPG",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0001.JPG",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7624737",
                "ns": 6,
                "title": "File:Graffiti 0001.JPG"
            },
            {
                "name": "Graffiti_0002.JPG",
                "timestamp": "2006-10-26T02:03:40Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/6/66/Graffiti_0002.JPG",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0002.JPG",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7624935",
                "ns": 6,
                "title": "File:Graffiti 0002.JPG"
            },
            {
                "name": "Graffiti_0003.JPG",
                "timestamp": "2006-10-26T08:05:08Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/2/2b/Graffiti_0003.JPG",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:Graffiti_0003.JPG",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=7628426",
                "ns": 6,
                "title": "File:Graffiti 0003.JPG"
            }
        ]
    }
}

{
    "batchcomplete": "",
    "continue": {
        "aicontinue": "20100101190633|Ryan_Baker_12-30-2009.JPG",
        "continue": "-||"
    },
    "query": {
        "allimages": [
            {
                "name": "DramaQueenThatGirl.jpg",
                "timestamp": "2010-01-01T18:21:57Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/1/17/DramaQueenThatGirl.jpg",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:DramaQueenThatGirl.jpg",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25646192",
                "ns": 6,
                "title": "File:DramaQueenThatGirl.jpg"
            },
            {
                "name": "VS_in_viena_austria.JPG",
                "timestamp": "2010-01-01T18:42:49Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/b/bd/VS_in_viena_austria.JPG",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:VS_in_viena_austria.JPG",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25646382",
                "ns": 6,
                "title": "File:VS in viena austria.JPG"
            },
            {
                "name": "Vasanthamtv_channel.jpg",
                "timestamp": "2010-01-01T19:03:08Z",
                "url": "https://upload.wikimedia.org/wikipedia/en/1/18/Vasanthamtv_channel.jpg",
                "descriptionurl": "https://en.wikipedia.org/wiki/File:Vasanthamtv_channel.jpg",
                "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=25626466",
                "ns": 6,
                "title": "File:Vasanthamtv channel.jpg"
            }
            ...
        ]
    }
}

Parameter history

• v1.23: Introduced aiprop=canonicaltitle, aiprop=commonmetadata, aiprop=extmetadata
• v1.20: Introduced aisort, aistart, aiend, aiuser, aifilterbots, aidir=newer, aidir=older
• v1.18: Introduced aimime, aiprop=mediatype
• v1.17: Introduced aiprop=userid, aiprop=parsedcomment
• v1.14: Introduced bitdepth

Additional notes

• Only the most recent version of each file is returned.
• See Data formats for more information on how to properly format dates for aisort=timestamps

See also

• API:Images - a very similar module, but it is a prop, not a list; see API:Properties and API:Lists for more details on how these two kinds of modules differ from one another.
• API:Imageinfo - retrieves detailed information about image files.
• API:Stashimageinfo - retrieves information about stashed images.
• API:Fileusage - find all pages that use the given image or images.
• API:Duplicatefiles - find any duplicates of the given file or files.

API documentation

The following documentation is the output of Special:ApiHelp/query+alllinks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+alllinks

Example

By default, this module will return duplicates if a page contains multiple links pointing to the same namespace. This example uses alunique=1 to remove any duplicate titles in the response.

{
    "batchcomplete": "",
    "continue": {
        "alcontinue": "!!!!Hashtagging",
        "continue": "-||"
    },
    "query": {
        "alllinks": [
            {
                "ns": 0,
                "title": "!"
            },
            {
                "ns": 0,
                "title": "!!"
            },
            {
                "ns": 0,
                "title": "!!!"
            },
            ...
}

Possible errors

Additional notes

• As with other link modules within the Action API , this module returns the titles of the pages that link to the namespace, not the exact URIs to those pages.
• This module can be used as a generator.
• Previous versions would return an error if the user tried to run this module as a generator, and alunique was set to true. This was altered in v1.24, to allow using the module as a generator even if alunique is true.

See also

• API:Backlinks - lists links to a given page.
• API:Linkshere - similar to API:Backlinks , gets links to a given page. Note that, unlike API:Backlinks , which is a list module, API:Linkshere is a prop module. See the respective pages on API:Properties and API:Lists for how these two kinds of modules differ.
• API:Links - retrieves links on a given page or pages.

API documentation

The following documentation is the output of Special:ApiHelp/query+allpages, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+allpages

Example

{
    "batchcomplete": "",
    "continue": {
        "apcontinue": "Jungle_(Bakufu_Slump_album)",
        "continue": "-||"
    },
    "query": {
        "allpages": [
            {
                "pageid": 341265,
                "ns": 0,
                "title": "Jungle"
            },
            {
                "pageid": 56461312,
                "ns": 0,
                "title": "Jungle-runner"
            },
            {
                "pageid": 18698572,
                "ns": 0,
                "title": "Jungle/Drum n bass"
            },
            {
                "pageid": 1487899,
                "ns": 0,
                "title": "Jungle2jungle"
            },
            {
                "pageid": 30391179,
                "ns": 0,
                "title": "JunglePup"
            }
            ...
        ]
    }
}

Possible errors

See also

• Chris G's botclasses/AllPagesBot.php — a bot that retrieves all files on a wiki, utilizing this API
• API:Categorymembers — lists all pages within a category
• API:Categories — lists all categories associated with a certain page, which can aid in finding similar pages
• API:Allcategories — lists all categories fitting a certain criteria
• API:Allimages — lists all images whose file names fit a certain criteria
• API:Allusers — lists all users in alphabetical order

API documentation

The following documentation is the output of Special:ApiHelp/query+alltransclusions, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+alltransclusions

Example

{
    "batchcomplete": "",
    "continue": {
        "atcontinue": "!Hero_(album)",
        "continue": "-||"
    },
    "query": {
        "alltransclusions": [
            {
                "ns": 0,
                "title": "!!Destroy-Oh-Boy!!"
            },
            {
                "ns": 0,
                "title": "!Action Pact!"
            },
            {
                "ns": 0,
                "title": "!Arriba!"
            }
        ]
    }
}

Possible errors

Additional notes

• This module is part of API:Alllinks .

See also

• API:Templates - Gets a list of all pages transcluded in a page.

API documentation

The following documentation is the output of Special:ApiHelp/query+allusers, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+allusers

Example

{
    "batchcomplete": "",
    "continue": {
        "aufrom": "Drovark",
        "continue": "-||"
    },
    "query": {
        "allusers": [
            {
                "userid": 13239275,
                "name": "Drov"
            },
            {
                "userid": 7080866,
                "name": "Drova"
            },
            {
                "userid": 16013473,
                "name": "Drova 82"
            },
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.12: Introduced auprop=registration

Additional notes

• This API call is case sensitive, so aufrom=DROV doesn't return the same results as aufrom=Drov.
• All registered usernames are saved and retrieved in capitalized form. If you are using aufrom or auprefix in your query, make sure you are passing them values that start with an uppercase character.
• Although the default behavior is to list any user in the database, we can also limit our response to only those users who belong to a certain group, such as sysops, or bots. User groups are how MediaWiki grants users certain rights and privileges; see Help:User rights and groups for more details on how this system works.

See also

• API:Users - finds information about a list of users.

API documentation

The following documentation is the output of Special:ApiHelp/query+backlinks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+backlinks

Example

{
    "batchcomplete": "",
    "continue": {
        "blcontinue": "1|987",
        "continue": "-||"
    },
    "query": {
        "backlinks": [
            {
                "pageid": 12,
                "ns": 0,
                "title": "Anarchism"
            },
            {
                "pageid": 128,
                "ns": 1,
                "title": "Talk:Atlas Shrugged"
            },
            {
                "pageid": 336,
                "ns": 0,
                "title": "Altruism"
            },
            ...
        ]
    }
}

Possible errors

See also

• API:Linkshere - finds all pages that link to a given page. Note that, unlike API:Backlinks, which is a list module, API:Linkshere is a prop module. See the respective pages on API:Properties and API:Lists for how these two kinds of modules differ.
• API:Transcludedin - a prop module that finds all pages that transclude (i.e. embed information from) the given pages.
• API:Embeddedin - a list module which lists backlinks via transclusion, similar to Special:Whatlinkshere.
• API:Imageusage - lists pages that use the given image(s).
• API:Fileusage - lists pages that use the given file(s).

API documentation

The following documentation is the output of Special:ApiHelp/query+blocks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+blocks

Example

Lists the 3 most recent blocks

{
    "batchcomplete": "",
    "continue": {
        "bkcontinue": "20190226192632|8865878",
        "continue": "-||"
    },
    "query": {
        "blocks": [
            {
                "id": 8865881,
                "user": "168.11.166.47",
                "by": "Gilliam",
                "timestamp": "2019-02-26T19:28:56Z",
                "expiry": "2020-02-26T19:28:56Z",
                "reason": "{{school block}}",
                "rangestart": "168.11.166.47",
                "rangeend": "168.11.166.47",
                "anononly": "",
                "nocreate": "",
                "allowusertalk": ""
            },
            {
                "id": 8865880,
                "user": "64.125.67.43",
                "by": "Gilliam",
                "timestamp": "2019-02-26T19:27:44Z",
                "expiry": "2019-03-01T19:27:44Z",
                "reason": "part of mass attack",
                "rangestart": "64.125.67.43",
                "rangeend": "64.125.67.43",
                "anononly": "",
                "nocreate": "",
                "allowusertalk": ""
            }
            ...
        ]
    }
}

Additional notes

• This module cannot be used as a generator.

Parameter history

• v1.19: Introduced bkshow
• v1.18: Introduced userid

See also

• Extension:GlobalBlocking/API

API documentation

The following documentation is the output of Special:ApiHelp/query+categorymembers, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+categorymembers

Example 1: List twenty pages in a category

{
	"api": {
		"query-continue": {
			"categorymembers": {
				"_cmcontinue": "subcat|44594e414d494353|10998823"
			}
		},
		"query": {
			"categorymembers": {
				"cm": [
					{
						"_pageid": "22688097",
						"_ns": "0",
						"_title": "Branches of physics"
					},
					{
						"_pageid": "3445246",
						"_ns": "0",
						"_title": "Glossary of classical physics"
					},
					{
						"_pageid": "24489",
						"_ns": "0",
						"_title": "Outline of physics"
					},
					...
				]
			}
		}
	}
}

Example 2: Get the ten articles most recently added to a category

{
	"api": {
		"query-continue": {
			"categorymembers": {
				"_cmcontinue": "Magnetic levitation|"
			}
		},
		"query": {
			"categorymembers": {
				"cm": [
					{
						"_pageid": "1653925",
						"_ns": "100",
						"_title": "Portal:Physics"
					},
					{
						"_pageid": "22939",
						"_ns": "0",
						"_title": "Physics"
					},
					{
						"_pageid": "3445246",
						"_ns": "0",
						"_title": "Glossary of classical physics"
					},
					...
				]
			}
		}
	}
}

Example 3: Get ten subcategories of a category

{
	"api": {
		"query-continue": {
			"categorymembers": {
				"_cmcontinue": "subcat|57494b4950454449412050454f504c45|41491664"
			}
		},
		"query": {
			"categorymembers": {
				"cm": [
					{
						"_pageid": "1458692",
						"_ns": "14",
						"_title": "Category:Wikipedias by language"
					},
					{
						"_pageid": "22918730",
						"_ns": "14",
						"_title": "Category:Books about Wikipedia"
					},
					{
						"_pageid": "16957584",
						"_ns": "14",
						"_title": "Category:Critics of Wikipedia"
					},
					...
				]
			}
		}
	}
}

Possible errors

Parameter history

• v1.24: Deprecated cmstartsortkey, cmendsortkey
• v1.18: Introduced cmstartsortkeyprefix, cmendsortkeyprefix
• v1.17: Introduced sortkeyprefix, type
• v1.14: Introduced cmstartsortkey, cmendsortkey
• v1.12: Introduced cmtype,cmstart, cmend, cmdir

See also

• API:Allpages - lists all pages fitting certain criteria
• API:Categories - lists categories associated with a page
• API:Allcategories - lists all categories on a wiki

API documentation

The following documentation is the output of Special:ApiHelp/query+deletedrevs, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+deletedrevs

Example

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <deletedrevs drstart="20070904142729" />
  </query-continue>
  <query>
    <deletedrevs>
      <page title="Main Page" ns="0" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904200804" revid="31" user="Catrope" minor="" len="" />
          <rev timestamp="20070904200753" revid="30" user="Catrope" minor="" len="" />
          <rev timestamp="20070904193501" revid="29" user="Catrope" minor="" len="568" />
          <rev timestamp="20070904193213" revid="28" user="Catrope" minor="" len="470" />
        </revisions>
      </page>
      <page title="User:Catrope" ns="2" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904143938" revid="24" user="Catrope" len="52" />
          <rev timestamp="20070904142758" revid="23" user="Catrope" len="37" />
        </revisions>
      </page>
    </deletedrevs>
  </query>
</api>

#!/usr/bin/python3

"""
    get_deleted_revisions.py

    MediaWiki Action API Code Samples
    Demo of `Deletedrevs` module: List the six most recent deleted revisions
    from User:Catrope

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "drend": "20070904000000",
    "format": "json",
    "druser": "Catrope",
    "list": "deletedrevs",
    "drstart": "20070904235959",
    "drlimit": "6",
    "drprop": "revid|user|minor|len|token",
    "action": "query"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

print(DATA)

Possible errors

Parameter history

• v1.24: Deprecated drprop: token
• v1.23: Introduced drtag, drprop: tags
• v1.19: Introduced drprop: sha1
• v1.18: Introduced drto, drprefix, drprop: parentid
• v1.17: Introduced drprop: userid
• v1.16: Introduced drprop: parsedcomment
• v1.15: Introduced druser,drexcludeuser,drnamespace, drunique,drfrom

Additional notes

• This module cannot be used as a generator .
• You need the deletedhistory right to use this module. This module can be used in one of three modes:
  • List deleted revisions for the given titles (through titles or a generator), sorted by timestamp
  • List deleted contributions for a certain user, sorted by timestamp (druser set, no titles given)
  • 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.

See also

• API:Alldeletedrevisions

API documentation

The following documentation is the output of Special:ApiHelp/query+embeddedin, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+embeddedin

Example

{
    "batchcomplete": "",
    "query": {
        "embeddedin": [
            {
                "pageid": 14388072,
                "ns": 100,
                "title": "Portal:Computing"
            },
            {
                "pageid": 45719527,
                "ns": 2,
                "title": "User:SoSivr/sandbox"
            }
        ]
    }
}

Possible errors

See also

• API:Transcludedin - Find all pages that transclude the given pages.
• API:Templates - Returns all pages transcluded on the given pages.
• API:Alltransclusions - Part of API:Alllinks module. This API gets a list all transclusions (pages embedded using {{x}}), including non-existing.
• API:Parsing wikitext - Parse content of a page and obtain the output.

API documentation

The following documentation is the output of Special:ApiHelp/query+exturlusage, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+exturlusage

Example

{
    "batchcomplete": "",
    "continue": {
        "eucontinue": "http://org.slashdot./|169423",
        "continue": "-||"
    },
    "query": {
        "exturlusage": [
            {
                "pageid": 533948,
                "ns": 2,
                "title": "User:Peter Ellis",
                "url": "http://slashdot.org"
            },
            {
                "pageid": 3274,
                "ns": 2,
                "title": "User:Alexdb",
                "url": "http://slashdot.org/"
            },
            {
                "pageid": 36471,
                "ns": 2,
                "title": "User:Joao",
                "url": "http://slashdot.org/"
            }
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.21: Introduced euexpandurl

See also

• API:Backlinks - lists links to a given page.
• API:Links - retrieves links on a given page or pages.
• API:Iwlinks - Find interwiki links on a given page (i.e, meta pages, special pages).
• API:Extlinks - Find all external links on a given page.
• API:Langlinks - Get a list of language links from the given page. Language links represent translations.
• API:Langbacklinks - Get a list of pages that contains a given language link.

API documentation

The following documentation is the output of Special:ApiHelp/query+filearchive, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+filearchive

Example

{
    "batchcomplete": "",
    "continue": {
        "facontinue": "0000007.jpg|20070128133944|288",
        "continue": "-||"
    },
    "query": {
        "filearchive": [
            {
                "id": 1778,
                "name": "!notedit.png",
                "ns": 6,
                "title": "File:!notedit.png",
                "timestamp": "2011-04-25T13:17:47Z"
            },
            {
                "id": 6949,
                "name": "\"Twilight_at_the_pond\"_by_A.A.Tutunov_(1976).jpg",
                "ns": 6,
                "title": "File:\"Twilight at the pond\" by A.A.Tutunov (1976).jpg",
                "timestamp": "2019-01-26T11:48:52Z"
            },
            {
                "id": 5814,
                "name": "---C--temp-Regelwerk.pdf",
                "ns": 6,
                "title": "File:---C--temp-Regelwerk.pdf",
                "timestamp": "2017-03-09T10:09:24Z"
            },
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.20: Introduced facontinue, mediatype, archivename
• v1.18: Introduced fato, fasha1, fasha1base36, parseddescription

API documentation

The following documentation is the output of Special:ApiHelp/query+imageusage, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+imageusage

Example

{
  "batchcomplete": "",
  "continue": {
    "continue": "-||",
    "iucontinue": "4|33464895"
  },
  "query": {
    "imageusage": [
      {
        "ns": 0,
        "pageid": 14072,
        "title": "History of Wikipedia"
      },
      {
        "ns": 4,
        "pageid": 16842768,
        "title": "Wikipedia:Wikipedia logos"
      },
      {
        "ns": 2,
        "pageid": 30536602,
        "title": "User:J Komara"
      }
    ]
  }
}

Possible errors

See also

• API:Images - Lists embedded media files on provided pages.
• API:Allimages - Lists all images, by title or timestamp.
• API:Imageinfo - Gets information for any titles in the image namespace.
• API:Stashimageinfo - Gets information for stashed images or files in the namespace.
• API:Duplicatefiles - Lists any duplicates of the given images or files.

API documentation

The following documentation is the output of Special:ApiHelp/query+iwbacklinks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+iwbacklinks

Example

{
    "batchcomplete": "",
    "continue": {
        "iwblcontinue": "wikibooks|Main_Page|438739",
        "continue": "-||"
    },
    "query": {
        "iwbacklinks": [
            {
                "pageid": 18606,
                "ns": 0,
                "title": "Liberation Tigers of Tamil Eelam"
            },
            {
                "pageid": 43347,
                "ns": 1,
                "title": "Talk:Vi"
            },
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.20: Introduced iwbldir

Additional notes

• This module can be used to find all pages that link to the given interwiki link. It finds all links using a prefix, or all links to a given title (with a given prefix). Using neither parameter returns All IW Links.

See also

• API:Iwlinks - List interwiki links from a given page.
• API:Links - Find all the links on the provided page(s).
• API:Linkshere - Find all pages that link to the given pages.
• API:Extlinks - Gets a list of all external links on the provided pages.

API documentation

The following documentation is the output of Special:ApiHelp/query+langbacklinks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+langbacklinks

Example

{
    "batchcomplete": "",
    "query": {
        "langbacklinks": []
    }
}

Possible errors

Parameter history

• v1.20: Introduced dir

Additional notes

• This module can be used to find all pages that link to the given language link. It finds all links using a language code, or all links to a given title (with a given language). Using neither parameter is effectively All Language Links.

See also

• API:Links - Returns all links from the given pages.
• API:Langlinks - Gets a list of all language links from the provided pages to other languages.

API documentation

The following documentation is the output of Special:ApiHelp/query+logevents, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+logevents

Example

{
  "batchcomplete": "",
  "continue": {
    "continue": "-||",
    "lecontinue": "20190606150600|99729503"
  },
  "query": {
    "logevents": [
      {
        "action": "create",
        "comment": "added to WikiProject (via [[WP:JWB]])",
        "logid": 99729506,
        "logpage": 60974819,
        "ns": 15,
        "pageid": 60974819,
        "params": {},
        "timestamp": "2019-06-06T15:06:07Z",
        "title": "Category talk:Electronic albums by Senegalese artists",
        "type": "create",
        "user": "Jevansen"
      }
      ...
    ]
  }
}

Possible errors

Parameter history

• v1.17: Introduced leaction

Additional notes

• This module cannot be used as a generator .
• For autoblock unblock entries, the title returned is shown as "User:$blockid". This is not a userpage, but just the way it is stored. See task T19781.
• When userid is 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 task T73020.
• See Manual:Log actions for log types and log actions, and their log parameters and log_search entries and descriptions.
• Every log action is logged in the Manual:Logging table . Users can see those edits on Special:Log, except for a few restricted logs like Special:Log/suppress.

See also

• API:Recentchanges - Gets a list of all recent changes.
• API:Database field and API property associations .

API documentation

The following documentation is the output of Special:ApiHelp/query+protectedtitles, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+protectedtitles

Example

{
    "batchcomplete": "",
    "continue": {
        "ptcontinue": "20190520051937|118|Dj_Consequence",
        "continue": "-||"
    },
    "query": {
        "protectedtitles": [
            {
                "ns": 118,
                "title": "Draft:DJ Consequence",
                "timestamp": "2019-05-20T05:34:39Z",
                "level": "sysop"
            },
            {
                "ns": 0,
                "title": "DJ Consequence",
                "timestamp": "2019-05-20T05:20:31Z",
                "level": "sysop"
            }
        ]
    }
}

Parameter history

• v1.23: Introduced continue
• v1.17: Introduced userid
• v1.16: Introduced parsedcomment

See also

• API:Protect - Change a page's protection level.

API documentation

The following documentation is the output of Special:ApiHelp/query+querypage, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+querypage

Example

{
  "batchcomplete": "", 
  "continue": {
    "continue": "-||", 
    "qpoffset": 10
  }, 
  "query": {
    "querypage": {
      "cached": "", 
      "cachedtimestamp": "2019-02-22T11:46:48Z", 
      "maxresults": 5000, 
      "name": "Uncategorizedpages", 
      "results": [
        {
          "ns": 0, 
          "title": "Abelardo Delgado", 
          "value": "0"
        }, 
        {
          "ns": 0, 
          "title": "Agriculture in Tonga", 
          "value": "0"
        }, 
        {
          "ns": 0, 
          "title": "Andriandramaka", 
          "value": "0"
        }
        ...
      ]
    }
  }
}

Possible errors

Additional notes

• This module can be used as a generator .
• Namespace filtering is unavailable on these pages. The possible way is to manually filter "ns" from collected results.

See also

• API:Allpages - Lists all pages fitting certain criteria, within a given Namespace .
• API:Categorymembers - Lists all pages within a category
• API:Pageswithprop - List all pages using a given page property.

API documentation

The following documentation is the output of Special:ApiHelp/query+random, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+random

Example

{

"batchcomplete": "",
    "continue": {
        "rncontinue": "0.559881820010|0.559881954661|47659388|0",
        "continue": "-||"
    },
    "query": {
        "random": [
            {
                "id": 32381675,
                "ns": 0,
                "title": "Mallabhum Institute of Technology"
            },
            {
                "id": 25126452,
                "ns": 3,
                "title": "User talk:96.232.132.176"
            },
            {
                "id": 1440028,
                "ns": 0,
                "title": "Hyundai Epsilon engine"
            },
            {
                "id": 35446805,
                "ns": 15,
                "title": "Category talk:Ukrainian card games"
            },
            {
                "id": 12613,
                "ns": 0,
                "title": "Grue"
            }
        ]
    }
}

Parameter history

• v1.26: Previous limit of 10/20 on rnlimit was increased to standard 500/5000 limits.
• v1.26: Deprecated rnredirect
• v1.26: Introduced rnfilterredir
• v1.14: Introduced rnredirect

Additional notes

• Unlike most modules in the Action API , the default number of pages returned is 1, not 10.
• Pages are returned in a fixed sequence; only the starting point is actually random.
• The default behavior is to pick pages from across the entire wiki, including talk pages, user pages, and so on. If you are looking for similar functionality as Special:Random, i.e. pick random articles, restrict rnnamespace to 0.
• If the number of pages is fewer than rnlimit, the request will simply return all available pages. It will not repeat pages to pad out the response up to the limit.

See also

• Manual:Random page - describes how to configure the API on the backend.

API documentation

The following documentation is the output of Special:ApiHelp/query+recentchanges, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+recentchanges

Example

{
    "batchcomplete": "",
    "continue": {
        "rccontinue": "20180330090522|1041353210",
        "continue": "-||"
    },
    "query": {
        "recentchanges": [
            {
                "type": "edit",
                "ns": 0,
                "title": "Histology",
                "pageid": 13570,
                "revid": 833218500,
                "old_revid": 833218201,
                "rcid": 1041353213,
                "user": "Iztwoz",
                "oldlen": 25718,
                "newlen": 25749
            }
            ...
        ]
    }
}

Sample code

API:Lists/All/Sample code 1

Possible errors

Parameter history

• v1.24: Deprecated rctoken
• v1.15: Removed rctitles
• v1.14: Introduced rctitles
• v1.13: Introduced loginfo

Additional notes

• Many log actions can be viewed using this module excluding patrol actions as they are not present in the recentchanges table.
• The Timestamp to start listing from may not be more than $wgRCMaxAge into the past, which on Wikimedia wikis is 30 days.
• New changes may be inserted to the recentchanges table slightly out of order with respect to their timestamp. Thus, when requesting the most recent changes twice in a row, the second response may contain new changes inserted a few seconds before the most recent one in the first response. If you repeatedly call this module to get a stream a recent change, consider adding some overlap between requests to not miss any changes.
• This module can be used as a generator.
• This module is implemented by ApiQueryRecentChanges.php .

See also

• API:Database field and API property associations
• API:Recent changes stream

API documentation

The following documentation is the output of Special:ApiHelp/query+search, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+search

{
    "batchcomplete": "",
    "continue": {
        "sroffset": 10,
        "continue": "-||"
    },
    "query": {
        "searchinfo": {
            "totalhits": 5060
        },
        "search": [
            {
                "ns": 0,
                "title": "Nelson Mandela",
                "pageid": 21492751,
                "size": 196026,
                "wordcount": 23664,
                "snippet": "<span class=\"searchmatch\">Nelson</span> Rolihlahla <span class=\"searchmatch\">Mandela</span> (/mænˈdɛlə/, Xhosa: [xoliɬaˈɬa <span class=\"searchmatch\">manˈdɛla</span>]; 18 July 1918 – 5 December 2013) was a South African anti-apartheid revolutionary,",
                "timestamp": "2018-07-23T07:59:43Z"
            },
            {
                "ns": 0,
                "title": "Death of Nelson Mandela",
                "pageid": 41284488,
                "size": 133513,
                "wordcount": 13512,
                "snippet": "On December 5, 2013, <span class=\"searchmatch\">Nelson</span> <span class=\"searchmatch\">Mandela</span>, the first President of South Africa to be elected in a fully representative democratic election, as well as the country's",
                "timestamp": "2018-07-19T17:30:59Z"
            }
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.24: Deprecated score,hasrelated
• v1.23:
  • Removed srredirects. Redirects are always included.
  • Introduced srinterwiki
• v1.22: Introduced srbackend
• v1.17: Introduced nearmatch, score, titlesnippet, redirecttitle, redirectsnippet, sectiontitle, sectionsnippet, hasrelated
• v1.16: Introduced srinfo, srprop

Additional notes

• Depending on which search backend is in use, how srsearch is interpreted may vary. On Wikimedia wikis which use CirrusSearch, see Help:CirrusSearch for information about the search syntax.

See also

• API:Opensearch
• API:All search modules

API documentation

The following documentation is the output of Special:ApiHelp/query+tags, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+tags

Example

{
  "batchcomplete": "",
  "continue": {
    "continue": "-||",
    "tgcontinue": "Extraneous formatting"
  },
  "query": {
    "tags": [
      {
        "hitcount": 2481517,
        "name": "AWB"
      },
      {
        "hitcount": 10849,
        "name": "Addition of interwiki link"
      },
      {
        "hitcount": 819,
        "name": "Citing predatory open access journal"
      }
    ]
  }
}

Additional notes

• This module cannot be used as a Generator .

See also

• API:Recentchanges - List recent changes
• API:Managetags - Define or delete tags

API documentation

The following documentation is the output of Special:ApiHelp/query+usercontribs, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+usercontribs

Example

{
    "batchcomplete": "",
    "continue": {
        "uccontinue": "20190130180447|880978627",
        "continue": "-||"
    },
    "query": {
        "usercontribs": [
            {
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9870625,
                "revid": 881893498,
                "parentid": 881892978,
                "ns": 3,
                "title": "User talk:Jimbo Wales",
                "timestamp": "2019-02-05T14:05:11Z",
                "comment": "/* Fancy I edit Wikipedia T-Shirt */",
                "size": 29753
            },
            {
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9870625,
                "revid": 881282261,
                "parentid": 881270759,
                "ns": 3,
                "title": "User talk:Jimbo Wales",
                "timestamp": "2019-02-01T15:29:31Z",
                "comment": "/* Macedonian President Gorge Ivanov is now in the House arrest */",
                "size": 60166
            },
            {
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9513191,
                "revid": 881245934,
                "parentid": 881240310,
                "ns": 1,
                "title": "Talk:Mark Dice",
                "timestamp": "2019-02-01T09:48:38Z",
                "comment": "/* So good they names it twice */",
                "size": 74128
            },
            ...
        ]
    }
}

Possible errors

Parameter history

• v1.39: Introduced uciprange
• v1.29: Introduced ucuserids
• v1.23: Deprecated uctoponly
• v1.23: Introduced ucshow=top, ucshow=!top, ucshow=new, ucshow=!new
• v1.20: Introduced ucprop=sizediff
• v1.18: Introduced uctoponly
• v1.16: Introduced ucprop=parsedcomment, ucprop=size, ucprop=tags, uctag
• v1.15: Introduced ucprop=patrolled, ucshow=patrolled, ucshow=!patrolled
• v1.14: Introduced uccontinue
• v1.13: Introduced ucuserprefix
• v1.11: Introduced ucnamespace, ucprop, ucshow

Additional notes

• The module returns page edits and moves, but not other operations, such as uploads.
• Prior to MediaWiki v1.14, the start parameter was used to view additional results within the response. Between v1.14 and v1.22, start was used to continue when listing a single user's contributions; continue was used when listing contributions from multiple users. From v1.23 forwards, all queries use continue.

See also

• API:Logevents - shows many kinds of user activity, including uploads

API documentation

The following documentation is the output of Special:ApiHelp/query+users, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+users

Example

{
    "batchcomplete": "",
    "query": {
        "users": [
            {
                "name": "1.2.3.4",
                "invalid": ""
            },
            {
                "userid": 4587601,
                "name": "Catrope",
                "editcount": 359,
                "registration": "2007-06-07T16:36:03Z",
                "groups": [
                    "*",
                    "user",
                    "autoconfirmed"
                ],
                "emailable": "",
                "gender": "male"
            },
            {
                "name": "Vandal01",
                "missing": ""
            },
            {
                "userid": 2793024,
                "name": "Bob",
                "editcount": 4542,
                "registration": "2006-11-18T21:55:03Z",
                "groups": [
                    "extendedconfirmed",
                    "reviewer",
                    "*",
                    "user",
                    "autoconfirmed"
                ],
                "emailable": "",
                "gender": "male"
            }
        ]
    }
}

Parameter history

• v1.29: Introduced ususerids, userrights
• v1.24: Deprecated ustoken
• v1.18: Introduced implicitgroups
• v1.17: Introduced rights
• v1.16: Introduced ususerids, gender
• v1.14: Introduced emailable
• v1.13: Introduced registration

See also

• Help:User rights and groups - More information on user rights, and how they relate to groups
• API:User group membership - Adding and removing users from groups
• API:Allusers - Lists registered users in alphabetical order
• Extension:CentralAuth/API - Global user info

API documentation

The following documentation is the output of Special:ApiHelp/query+watchlist, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+watchlist

Example

{
  "batchcomplete": "",
  "query": {
    "watchlist": [
      {
        "ns": 1,
        "old_revid": 898447862,
        "pageid": 5858,
        "revid": 898447924,
        "title": "Talk:Software",
        "type": "edit"
      },
      {
        "ns": 0,
        "old_revid": 896386764,
        "pageid": 18934886,
        "revid": 897854521,
        "title": "Proprietary software",
        "type": "edit"
      },
      {
        "minor": "",
        "ns": 0,
        "old_revid": 894771707,
        "pageid": 1721496,
        "revid": 897348916,
        "title": "Free and open-source software",
        "type": "edit"
      }
    ]
  }
}

Possible errors

Parameter history

• v1.24: Introduced unread, !unread
• v1.23: Introduced wlcontinue
• v1.22: Introduced wltype
• v1.18: Introduced loginfo
• v1.17: Introduced userid
• v1.16: Introduced wluser, wlexcludeuser, parsedcomment, notificationtimestamp, wlowner, wltoken
• v1.14: Introduced patrolled, !patrolled
• v1.12: Introduced wlshow
• v1.11: Introduced ids, title, flags, sizes

Additional Notes

• This module should not be confused with API:Watchlistraw , which lists all the pages on the logged in user's watchlist, regardless of whether they were recently changed or not.

See also

• API:Watch - Edit the watchlist.
• API:Watchlistraw - Get all the pages on the logged in user's watchlist, regardless of whether they were recently changed or not.
• API:Watchlist feed - Get the RSS feed of a user's watchlist.

API documentation

The following documentation is the output of Special:ApiHelp/query+watchlistraw, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org). Special:ApiHelp/query+watchlistraw

Example

{
  "batchcomplete": "",
  "continue": {
    "continue": "-||",
    "wrcontinue": "0|Software"
  },
  "watchlistraw": [
    {
      "ns": 0,
      "title": "Free and open-source software"
    },
    {
      "ns": 0,
      "title": "Free software"
    },
    {
      "ns": 0,
      "title": "Proprietary software"
    }
  ]
}

Possible errors

Parameter history

• v1.20: Introduced wrdir
• v1.17: Introduced wrowner, wrtoken

Additional notes

• This module should not be confused with API:Watchlist , which returns 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.
• The results of this query module are returned as part of the api node, not the query node.

See also

• API:Watchlist - Get pages on a user's watchlist that were changed within the given time period, ordered by time of the last change of the watched page.
• API:Watchlist feed - Get the RSS feed of a user's watchlist.