\
MediaWiki API
<?xml version="1.0"?>
<api>
<error code="unknown_action" info="Unrecognized value for parameter 'action': https://world-of-warships-codes.linegames.org" xml:space="preserve">
******************************************************************
** **
** This is an auto-generated MediaWiki API documentation page **
** **
** Documentation and Examples: **
** http://www.mediawiki.org/wiki/API **
** **
******************************************************************
Status: All features shown on this page should be working, but the API
is still in active development, and may change at any time.
Make sure to monitor our mailing list for any updates.
Documentation: http://www.mediawiki.org/wiki/API
Mailing list: http://lists.wikimedia.org/mailman/listinfo/mediawiki-api
Bugs & Requests: http://bugzilla.wikimedia.org/buglist.cgi?component=API&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&order=bugs.delta_ts
Parameters:
format - The format of the output
One value: json, jsonfm, php, phpfm, wddx, wddxfm, xml, xmlfm, yaml, yamlfm, rawfm, txt, txtfm, dbg, dbgfm
Default: xmlfm
action - What action you would like to perform
One value: login, logout, query, expandtemplates, parse, opensearch, feedwatchlist, help, paraminfo, purge, rollback, delete, undelete, protect, block, unblock, move, edit, upload, emailuser, watch, patrol, import, userrights
Default: help
version - When showing help, include version for each module
maxlag - Maximum lag
smaxage - Set the s-maxage header to this many seconds. Errors are never cached
Default: 0
maxage - Set the max-age header to this many seconds. Errors are never cached
Default: 0
requestid - Request ID to distinguish requests. This will just be output back to you
*** *** *** *** *** *** *** *** *** *** Modules *** *** *** *** *** *** *** *** *** ***
* action=login (lg) *
This module is used to login and get the authentication tokens.
In the event of a successful log-in, a cookie will be attached
to your session. In the event of a failed log-in, you will not
be able to attempt another log-in through this method for 5 seconds.
This is to prevent password guessing by automated password crackers.
This module only accepts POST requests.
Parameters:
lgname - User Name
lgpassword - Password
lgdomain - Domain (optional)
lgtoken - Login token obtained in first request
Example:
api.php?action=login&lgname=user&lgpassword=password
* action=logout *
This module is used to logout and clear session data
Example:
api.php?action=logout
* action=query *
Query API module allows applications to get needed pieces of data from the MediaWiki databases,
and is loosely based on the old query.php interface.
All data modifications will first have to use query to acquire a token to prevent abuse from malicious sites.
This module requires read rights.
Parameters:
titles - A list of titles to work on
pageids - A list of page IDs to work on
revids - A list of revision IDs to work on
prop - Which properties to get for the titles/revisions/pageids
Values (separate with '|'): info, revisions, links, langlinks, images, imageinfo, templates, categories, extlinks, categoryinfo, duplicatefiles
list - Which lists to get
Values (separate with '|'): allimages, allpages, alllinks, allcategories, allusers, backlinks, blocks, categorymembers, deletedrevs, embeddedin, imageusage, logevents, recentchanges, search, tags, usercontribs, watchlist, watchlistraw, exturlusage, users, random, protectedtitles
meta - Which meta data to get about the site
Values (separate with '|'): siteinfo, userinfo, allmessages
generator - Use the output of a list as the input for other prop/list/meta items
NOTE: generator parameter names must be prefixed with a 'g', see examples.
One value: links, images, templates, categories, duplicatefiles, allimages, allpages, alllinks, allcategories, backlinks, categorymembers, embeddedin, imageusage, search, watchlist, watchlistraw, exturlusage, random, protectedtitles
redirects - Automatically resolve redirects
indexpageids - Include an additional pageids section listing all returned page IDs.
export - Export the current revisions of all given or generated pages
exportnowrap - Return the export XML without wrapping it in an XML result (same format as Special:Export). Can only be used with export
Examples:
api.php?action=query&prop=revisions&meta=siteinfo&titles=Main%20Page&rvprop=user|comment
api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions
--- --- --- --- --- --- --- --- Query: Prop --- --- --- --- --- --- --- ---
* prop=info (in) *
Get basic page information such as namespace, title, last touched date, ...
This module requires read rights.
Parameters:
inprop - Which additional properties to get:
protection - List the protection level of each page
talkid - The page ID of the talk page for each non-talk page
watched - List the watched status of each page
subjectid - The page ID of the parent page for each talk page
url - Gives a full URL to the page, and also an edit URL
readable - Whether the user can read this page
preload - Gives the text returned by EditFormPreloadText
Values (separate with '|'): protection, talkid, watched, subjectid, url, readable, preload
intoken - Request a token to perform a data-modifying action on a page
Values (separate with '|'): edit, delete, protect, move, block, unblock, email, import
incontinue - When more results are available, use this to continue
Examples:
api.php?action=query&prop=info&titles=Main%20Page
api.php?action=query&prop=info&inprop=protection&titles=Main%20Page
* prop=revisions (rv) *
Get revision information.
This module may be used in several ways:
1) Get data about a set of pages (last revision), by setting titles or pageids parameter.
2) Get revisions for one given page, by using titles/pageids with start/end/limit params.
3) Get data about a set of revisions by setting their IDs with revids parameter.
All parameters marked as (enum) may only be used with a single page (#2).
This module requires read rights.
Parameters:
rvprop - Which properties to get for each revision.
Values (separate with '|'): ids, flags, timestamp, user, size, comment, parsedcomment, content, tags
Default: ids|timestamp|flags|comment|user
rvlimit - Limit how many revisions will be returned (enum)
No more than 500 (5000 for bots) allowed.
rvstartid - From which revision id to start enumeration (enum)
rvendid - Stop revision enumeration on this revid (enum)
rvstart - From which revision timestamp to start enumeration (enum)
rvend - Enumerate up to this timestamp (enum)
rvdir - Direction of enumeration - towards "newer" or "older" revisions (enum)
One value: newer, older
Default: older
rvuser - Only include revisions made by user
rvexcludeuser - Exclude revisions made by user
rvtag - Only list revisions tagged with this tag
rvexpandtemplates - Expand templates in revision content
rvgeneratexml - Generate XML parse tree for revision content
rvsection - Only retrieve the content of this section
rvtoken - Which tokens to obtain for each revision
Values (separate with '|'): rollback
rvcontinue - When more results are available, use this to continue
rvdiffto - Revision ID to diff each revision to.
Use "prev", "next" and "cur" for the previous, next and current revision respectively.
rvdifftotext - Text to diff each revision to. Only diffs a limited number of revisions.
Overrides diffto. If rvsection is set, only that section will be diffed against this text.
Examples:
Get data with content for the last revision of titles "API" and "Main Page":
api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content
Get last 5 revisions of the "Main Page":
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment
Get first 5 revisions of the "Main Page":
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer
Get first 5 revisions of the "Main Page" made after 2006-05-01:
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=20060501000000
Get first 5 revisions of the "Main Page" that were not made made by anonymous user "127.0.0.1"
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1
Get first 5 revisions of the "Main Page" that were made by the user "MediaWiki default"
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default
* prop=links (pl) *
Returns all links from the given page(s)
This module requires read rights.
Parameters:
plnamespace - Show links in this namespace(s) only
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
pllimit - How many links to return
No more than 500 (5000 for bots) allowed.
Default: 10
plcontinue - When more results are available, use this to continue
Examples:
Get links from the [[Main Page]]:
api.php?action=query&prop=links&titles=Main%20Page
Get information about the link pages in the [[Main Page]]:
api.php?action=query&generator=links&titles=Main%20Page&prop=info
Get links from the Main Page in the User and Template namespaces:
api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10
Generator:
This module may be used as a generator
* prop=langlinks (ll) *
Returns all interlanguage links from the given page(s)
This module requires read rights.
Parameters:
lllimit - How many langlinks to return
No more than 500 (5000 for bots) allowed.
Default: 10
llcontinue - When more results are available, use this to continue
Examples:
Get interlanguage links from the [[Main Page]]:
api.php?action=query&prop=langlinks&titles=Main%20Page&redirects
* prop=images (im) *
Returns all images contained on the given page(s)
This module requires read rights.
Parameters:
imlimit - How many images to return
No more than 500 (5000 for bots) allowed.
Default: 10
imcontinue - When more results are available, use this to continue
Examples:
Get a list of images used in the [[Main Page]]:
api.php?action=query&prop=images&titles=Main%20Page
Get information about all images used in the [[Main Page]]:
api.php?action=query&generator=images&titles=Main%20Page&prop=info
Generator:
This module may be used as a generator
* prop=imageinfo (ii) *
Returns image information and upload history
This module requires read rights.
Parameters:
iiprop - What image information to get.
Values (separate with '|'): timestamp, user, comment, url, size, dimensions, sha1, mime, metadata, archivename, bitdepth
Default: timestamp|user
iilimit - How many image revisions to return
No more than 500 (5000 for bots) allowed.
Default: 1
iistart - Timestamp to start listing from
iiend - Timestamp to stop listing at
iiurlwidth - If iiprop=url is set, a URL to an image scaled to this width will be returned.
Only the current version of the image can be scaled.
Default: -1
iiurlheight - Similar to iiurlwidth. Cannot be used without iiurlwidth
Default: -1
iicontinue - When more results are available, use this to continue
Examples:
api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo
api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=20071231235959&iiprop=timestamp|user|url
* prop=templates (tl) *
Returns all templates from the given page(s)
This module requires read rights.
Parameters:
tlnamespace - Show templates in this namespace(s) only
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
tllimit - How many templates to return
No more than 500 (5000 for bots) allowed.
Default: 10
tlcontinue - When more results are available, use this to continue
Examples:
Get templates from the [[Main Page]]:
api.php?action=query&prop=templates&titles=Main%20Page
Get information about the template pages in the [[Main Page]]:
api.php?action=query&generator=templates&titles=Main%20Page&prop=info
Get templates from the Main Page in the User and Template namespaces:
api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10
Generator:
This module may be used as a generator
* prop=categories (cl) *
List all categories the page(s) belong to
This module requires read rights.
Parameters:
clprop - Which additional properties to get for each category.
Values (separate with '|'): sortkey, timestamp, hidden
clshow - Which kind of categories to show
Values (separate with '|'): hidden, !hidden
cllimit - How many categories to return
No more than 500 (5000 for bots) allowed.
Default: 10
clcontinue - When more results are available, use this to continue
clcategories - Only list these categories. Useful for checking whether a certain page is in a certain category
Examples:
Get a list of categories [[Albert Einstein]] belongs to:
api.php?action=query&prop=categories&titles=Albert%20Einstein
Get information about all categories used in the [[Albert Einstein]]:
api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info
Generator:
This module may be used as a generator
* prop=extlinks (el) *
Returns all external urls (not interwikies) from the given page(s)
This module requires read rights.
Parameters:
ellimit - How many links to return
No more than 500 (5000 for bots) allowed.
Default: 10
eloffset - When more results are available, use this to continue
Examples:
Get a list of external links on the [[Main Page]]:
api.php?action=query&prop=extlinks&titles=Main%20Page
* prop=categoryinfo (ci) *
Returns information about the given categories
This module requires read rights.
Parameters:
cicontinue - When more results are available, use this to continue
Example:
api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar
* prop=duplicatefiles (df) *
List all files that are duplicates of the given file(s).
This module requires read rights.
Parameters:
dflimit - How many files to return
No more than 500 (5000 for bots) allowed.
Default: 10
dfcontinue - When more results are available, use this to continue
Examples:
api.php?action=query&titles=File:Albert_Einstein_Head.jpg&prop=duplicatefiles
api.php?action=query&generator=allimages&prop=duplicatefiles
Generator:
This module may be used as a generator
--- --- --- --- --- --- --- --- Query: List --- --- --- --- --- --- --- ---
* list=allimages (ai) *
Enumerate all images sequentially
This module requires read rights.
Parameters:
aifrom - The image title to start enumerating from.
aiprefix - Search for all image titles that begin with this value.
aiminsize - Limit to images with at least this many bytes
aimaxsize - Limit to images with at most this many bytes
ailimit - How many total images to return.
No more than 500 (5000 for bots) allowed.
Default: 10
aidir - The direction in which to list
One value: ascending, descending
Default: ascending
aisha1 - SHA1 hash of image
aisha1base36 - SHA1 hash of image in base 36 (used in MediaWiki)
aiprop - Which properties to get
Values (separate with '|'): timestamp, user, comment, url, size, dimensions, sha1, mime, metadata, archivename, bitdepth
Default: timestamp|url
Examples:
Simple Use
Show a list of images starting at the letter "B"
api.php?action=query&list=allimages&aifrom=B
Using as Generator
Show info about 4 images starting at the letter "T"
api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo
Generator:
This module may be used as a generator
* list=allpages (ap) *
Enumerate all pages sequentially in a given namespace
This module requires read rights.
Parameters:
apfrom - The page title to start enumerating from.
apprefix - Search for all page titles that begin with this value.
apnamespace - The namespace to enumerate.
One value: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Default: 0
apfilterredir - Which pages to list.
One value: all, redirects, nonredirects
Default: all
apminsize - Limit to pages with at least this many bytes
apmaxsize - Limit to pages with at most this many bytes
apprtype - Limit to protected pages only
Values (separate with '|'): edit, move
apprlevel - The protection level (must be used with apprtype= parameter)
Can be empty, or Values (separate with '|'): autoconfirmed, sysop
apprfiltercascade - Filter protections based on cascadingness (ignored when apprtype isn't set)
One value: cascading, noncascading, all
Default: all
aplimit - How many total pages to return.
No more than 500 (5000 for bots) allowed.
Default: 10
apdir - The direction in which to list
One value: ascending, descending
Default: ascending
apfilterlanglinks - Filter based on whether a page has langlinks
One value: withlanglinks, withoutlanglinks, all
Default: all
Examples:
Simple Use
Show a list of pages starting at the letter "B"
api.php?action=query&list=allpages&apfrom=B
Using as Generator
Show info about 4 pages starting at the letter "T"
api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info
Show content of first 2 non-redirect pages begining at "Re"
api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content
Generator:
This module may be used as a generator
* list=alllinks (al) *
Enumerate all links that point to a given namespace
This module requires read rights.
Parameters:
alcontinue - When more results are available, use this to continue.
alfrom - The page title to start enumerating from.
alprefix - Search for all page titles that begin with this value.
alunique - Only show unique links. Cannot be used with generator or prop=ids
alprop - What pieces of information to include
Values (separate with '|'): ids, title
Default: title
alnamespace - The namespace to enumerate.
One value: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Default: 0
allimit - How many total links to return.
No more than 500 (5000 for bots) allowed.
Default: 10
Example:
api.php?action=query&list=alllinks&alunique&alfrom=B
Generator:
This module may be used as a generator
* list=allcategories (ac) *
Enumerate all categories
This module requires read rights.
Parameters:
acfrom - The category to start enumerating from.
acprefix - Search for all category titles that begin with this value.
acdir - Direction to sort in.
One value: ascending, descending
Default: ascending
aclimit - How many categories to return.
No more than 500 (5000 for bots) allowed.
Default: 10
acprop - Which properties to get
Values (separate with '|'): size, hidden
Default:
Examples:
api.php?action=query&list=allcategories&acprop=size
api.php?action=query&generator=allcategories&gacprefix=List&prop=info
Generator:
This module may be used as a generator
* list=allusers (au) *
Enumerate all registered users
This module requires read rights.
Parameters:
aufrom - The user name to start enumerating from.
auprefix - Search for all page titles that begin with this value.
augroup - Limit users to a given group name
One value: bot, sysop, bureaucrat
auprop - What pieces of information to include.
`groups` property uses more server resources and may return fewer results than the limit.
Values (separate with '|'): blockinfo, groups, editcount, registration
aulimit - How many total user names to return.
No more than 500 (5000 for bots) allowed.
Default: 10
auwitheditsonly - Only list users who have made edits
Example:
api.php?action=query&list=allusers&aufrom=Y
* list=backlinks (bl) *
Find all pages that link to the given page
This module requires read rights.
Parameters:
bltitle - Title to search.
blcontinue - When more results are available, use this to continue.
blnamespace - The namespace to enumerate.
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
blfilterredir - How to filter for redirects. If set to nonredirects when blredirect is enabled, this is only applied to the second level
One value: all, redirects, nonredirects
Default: all
bllimit - How many total pages to return. If blredirect is enabled, limit applies to each level separately (which means you may get up to 2 * limit results).
No more than 500 (5000 for bots) allowed.
Default: 10
blredirect - If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.
Examples:
api.php?action=query&list=backlinks&bltitle=Main%20Page
api.php?action=query&generator=backlinks&gbltitle=Main%20Page&prop=info
Generator:
This module may be used as a generator
* list=blocks (bk) *
List all blocked users and IP addresses.
This module requires read rights.
Parameters:
bkstart - The timestamp to start enumerating from
bkend - The timestamp to stop enumerating at
bkdir - The direction in which to enumerate
One value: newer, older
Default: older
bkids - Pipe-separated list of block IDs to list (optional)
bkusers - Pipe-separated list of users to search for (optional)
bkip - Get all blocks applying to this IP or CIDR range, including range blocks.
Cannot be used together with bkusers. CIDR ranges broader than /16 are not accepted.
bklimit - The maximum amount of blocks to list
No more than 500 (5000 for bots) allowed.
Default: 10
bkprop - Which properties to get
Values (separate with '|'): id, user, by, timestamp, expiry, reason, range, flags
Default: id|user|by|timestamp|expiry|reason|flags
Examples:
api.php?action=query&list=blocks
api.php?action=query&list=blocks&bkusers=Alice|Bob
* list=categorymembers (cm) *
List all pages in a given category
This module requires read rights.
Parameters:
cmtitle - Which category to enumerate (required). Must include Category: prefix
cmprop - What pieces of information to include
Values (separate with '|'): ids, title, sortkey, timestamp
Default: ids|title
cmnamespace - Only include pages in these namespaces
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
cmcontinue - For large categories, give the value retured from previous query
cmlimit - The maximum number of pages to return.
No more than 500 (5000 for bots) allowed.
Default: 10
cmsort - Property to sort by
One value: sortkey, timestamp
Default: sortkey
cmdir - In which direction to sort
One value: asc, desc
Default: asc
cmstart - Timestamp to start listing from. Can only be used with cmsort=timestamp
cmend - Timestamp to end listing at. Can only be used with cmsort=timestamp
cmstartsortkey - Sortkey to start listing from. Can only be used with cmsort=sortkey
cmendsortkey - Sortkey to end listing at. Can only be used with cmsort=sortkey
Examples:
Get first 10 pages in [[Category:Physics]]:
api.php?action=query&list=categorymembers&cmtitle=Category:Physics
Get page info about first 10 pages in [[Category:Physics]]:
api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info
Generator:
This module may be used as a generator
* list=deletedrevs (dr) *
List deleted revisions.
This module operates in three modes:
1) List deleted revisions for the given title(s), sorted by timestamp
2) List deleted contributions for the given user, sorted by timestamp (no titles specified)
3) List all deleted revisions in the given namespace, sorted by title and timestamp (no titles specified, druser not set)
Certain parameters only apply to some modes and are ignored in others.
For instance, a parameter marked (1) only applies to mode 1 and is ignored in modes 2 and 3.
This module requires read rights.
Parameters:
drstart - The timestamp to start enumerating from. (1,2)
drend - The timestamp to stop enumerating at. (1,2)
drdir - The direction in which to enumerate. (1,2)
One value: newer, older
Default: older
drfrom - Start listing at this title (3)
drcontinue - When more results are available, use this to continue (3)
drunique - List only one revision for each page (3)
druser - Only list revisions by this user
drexcludeuser - Don't list revisions by this user
drnamespace - Only list pages in this namespace (3)
One value: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Default: 0
drlimit - The maximum amount of revisions to list
No more than 500 (5000 for bots) allowed.
Default: 10
drprop - Which properties to get
Values (separate with '|'): revid, user, comment, parsedcomment, minor, len, content, token
Default: user|comment
Examples:
List the last deleted revisions of Main Page and Talk:Main Page, with content (mode 1):
api.php?action=query&list=deletedrevs&titles=Main%20Page|Talk:Main%20Page&drprop=user|comment|content
List the last 50 deleted contributions by Bob (mode 2):
api.php?action=query&list=deletedrevs&druser=Bob&drlimit=50
List the first 50 deleted revisions in the main namespace (mode 3):
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50
List the first 50 deleted pages in the Talk namespace (mode 3):
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique
* list=embeddedin (ei) *
Find all pages that embed (transclude) the given title
This module requires read rights.
Parameters:
eititle - Title to search.
eicontinue - When more results are available, use this to continue.
einamespace - The namespace to enumerate.
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
eifilterredir - How to filter for redirects
One value: all, redirects, nonredirects
Default: all
eilimit - How many total pages to return.
No more than 500 (5000 for bots) allowed.
Default: 10
Examples:
api.php?action=query&list=embeddedin&eititle=Template:Stub
api.php?action=query&generator=embeddedin&geititle=Template:Stub&prop=info
Generator:
This module may be used as a generator
* list=imageusage (iu) *
Find all pages that use the given image title.
This module requires read rights.
Parameters:
iutitle - Title to search.
iucontinue - When more results are available, use this to continue.
iunamespace - The namespace to enumerate.
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
iufilterredir - How to filter for redirects. If set to nonredirects when iuredirect is enabled, this is only applied to the second level
One value: all, redirects, nonredirects
Default: all
iulimit - How many total pages to return. If iuredirect is enabled, limit applies to each level separately (which means you may get up to 2 * limit results).
No more than 500 (5000 for bots) allowed.
Default: 10
iuredirect - If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.
Examples:
api.php?action=query&list=imageusage&iutitle=File:Albert%20Einstein%20Head.jpg
api.php?action=query&generator=imageusage&giutitle=File:Albert%20Einstein%20Head.jpg&prop=info
Generator:
This module may be used as a generator
* list=logevents (le) *
Get events from logs.
This module requires read rights.
Parameters:
leprop - Which properties to get
Values (separate with '|'): ids, title, type, user, timestamp, comment, parsedcomment, details, tags
Default: ids|title|type|user|timestamp|comment|details
letype - Filter log entries to only this type(s)
Can be empty, or One value: block, protect, rights, delete, upload, move, import, patrol, merge, suppress, newusers
lestart - The timestamp to start enumerating from.
leend - The timestamp to end enumerating.
ledir - In which direction to enumerate.
One value: newer, older
Default: older
leuser - Filter entries to those made by the given user.
letitle - Filter entries to those related to a page.
letag - Only list event entries tagged with this tag.
lelimit - How many total event entries to return.
No more than 500 (5000 for bots) allowed.
Default: 10
Example:
api.php?action=query&list=logevents
* list=recentchanges (rc) *
Enumerate recent changes
This module requires read rights.
Parameters:
rcstart - The timestamp to start enumerating from.
rcend - The timestamp to end enumerating.
rcdir - In which direction to enumerate.
One value: newer, older
Default: older
rcnamespace - Filter log entries to only this namespace(s)
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rcuser - Only list changes by this user
rcexcludeuser - Don't list changes by this user
rctag - Only list changes tagged with this tag.
rcprop - Include additional pieces of information
Values (separate with '|'): user, comment, parsedcomment, flags, timestamp, title, ids, sizes, redirect, patrolled, loginfo, tags
Default: title|timestamp|ids
rctoken - Which tokens to obtain for each change
Values (separate with '|'): patrol
rcshow - Show only items that meet this criteria.
For example, to see only minor edits done by logged-in users, set show=minor|!anon
Values (separate with '|'): minor, !minor, bot, !bot, anon, !anon, redirect, !redirect, patrolled, !patrolled
rclimit - How many total changes to return.
No more than 500 (5000 for bots) allowed.
Default: 10
rctype - Which types of changes to show.
Values (separate with '|'): edit, new, log
Example:
api.php?action=query&list=recentchanges
* list=search (sr) *
Perform a full text search
This module requires read rights.
Parameters:
srsearch - Search for all page titles (or content) that has this value.
srnamespace - The namespace(s) to enumerate.
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Default: 0
srwhat - Search inside the text or titles.
One value: title, text
srinfo - What metadata to return.
Values (separate with '|'): totalhits, suggestion
Default: totalhits|suggestion
srprop - What properties to return.
Values (separate with '|'): size, wordcount, timestamp, snippet
Default: size|wordcount|timestamp|snippet
srredirects - Include redirect pages in the search.
sroffset - Use this value to continue paging (return by query)
Default: 0
srlimit - How many total pages to return.
No more than 50 (500 for bots) allowed.
Default: 10
Examples:
api.php?action=query&list=search&srsearch=meaning
api.php?action=query&list=search&srwhat=text&srsearch=meaning
api.php?action=query&generator=search&gsrsearch=meaning&prop=info
Generator:
This module may be used as a generator
* list=tags (tg) *
List change tags.
This module requires read rights.
Parameters:
tgcontinue - When more results are available, use this to continue
tglimit - The maximum number of tags to list
No more than 500 (5000 for bots) allowed.
Default: 10
tgprop - Which properties to get
Values (separate with '|'): name, displayname, description, hitcount
Default: name
Example:
api.php?action=query&list=tags&tgprop=displayname|description|hitcount
* list=usercontribs (uc) *
Get all edits by a user
This module requires read rights.
Parameters:
uclimit - The maximum number of contributions to return.
No more than 500 (5000 for bots) allowed.
Default: 10
ucstart - The start timestamp to return from.
ucend - The end timestamp to return to.
uccontinue - When more results are available, use this to continue.
ucuser - The user to retrieve contributions for.
ucuserprefix - Retrieve contibutions for all users whose names begin with this value. Overrides ucuser.
ucdir - The direction to search (older or newer).
One value: newer, older
Default: older
ucnamespace - Only list contributions in these namespaces
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
ucprop - Include additional pieces of information
Values (separate with '|'): ids, title, timestamp, comment, parsedcomment, size, flags, patrolled, tags
Default: ids|title|timestamp|comment|size|flags
ucshow - Show only items that meet this criteria, e.g. non minor edits only: show=!minor
NOTE: if show=patrolled or show=!patrolled is set, revisions older than $wgRCMaxAge won't be shown
Values (separate with '|'): minor, !minor, patrolled, !patrolled
uctag - Only list revisions tagged with this tag
Examples:
api.php?action=query&list=usercontribs&ucuser=YurikBot
api.php?action=query&list=usercontribs&ucuserprefix=217.121.114.
* list=watchlist (wl) *
Get all recent changes to pages in the logged in user's watchlist
This module requires read rights.
Parameters:
wlallrev - Include multiple revisions of the same page within given timeframe.
wlstart - The timestamp to start enumerating from.
wlend - The timestamp to end enumerating.
wlnamespace - Filter changes to only the given namespace(s).
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
wluser - Only list changes by this user
wlexcludeuser - Don't list changes by this user
wldir - In which direction to enumerate pages.
One value: newer, older
Default: older
wllimit - How many total results to return per request.
No more than 500 (5000 for bots) allowed.
Default: 10
wlprop - Which additional items to get (non-generator mode only).
Values (separate with '|'): ids, title, flags, user, comment, parsedcomment, timestamp, patrol, sizes, notificationtimestamp
Default: ids|title|flags
wlshow - Show only items that meet this criteria.
For example, to see only minor edits done by logged-in users, set show=minor|!anon
Values (separate with '|'): minor, !minor, bot, !bot, anon, !anon, patrolled, !patrolled
wlowner - The name of the user whose watchlist you'd like to access
wltoken - Give a security token (settable in preferences) to allow access to another user's watchlist
Examples:
api.php?action=query&list=watchlist
api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment
api.php?action=query&list=watchlist&wlallrev&wlprop=ids|title|timestamp|user|comment
api.php?action=query&generator=watchlist&prop=info
api.php?action=query&generator=watchlist&gwlallrev&prop=revisions&rvprop=timestamp|user
api.php?action=query&list=watchlist&wlowner=Bob_Smith&wltoken=d8d562e9725ea1512894cdab28e5ceebc7f20237
Generator:
This module may be used as a generator
* list=watchlistraw (wr) *
Get all pages on the logged in user's watchlist
This module requires read rights.
Parameters:
wrcontinue - When more results are available, use this to continue
wrnamespace - Only list pages in the given namespace(s).
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
wrlimit - How many total results to return per request.
No more than 500 (5000 for bots) allowed.
Default: 10
wrprop - Which additional properties to get (non-generator mode only).
Values (separate with '|'): changed
wrshow - Only list items that meet these criteria.
Values (separate with '|'): changed, !changed
Examples:
api.php?action=query&list=watchlistraw
api.php?action=query&generator=watchlistraw&gwrshow=changed&prop=revisions
Generator:
This module may be used as a generator
* list=exturlusage (eu) *
Enumerate pages that contain a given URL
This module requires read rights.
Parameters:
euprop - What pieces of information to include
Values (separate with '|'): ids, title, url
Default: ids|title|url
euoffset - Used for paging. Use the value returned for "continue"
euprotocol - Protocol of the url. If empty and euquery set, the protocol is http.
Leave both this and euquery empty to list all external links
Can be empty, or One value: http, https, ftp, irc, gopher, telnet, nntp, worldwind, mailto, news, svn
Default:
euquery - Search string without protocol. See [[Special:LinkSearch]]. Leave empty to list all external links
eunamespace - The page namespace(s) to enumerate.
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
eulimit - How many pages to return.
No more than 500 (5000 for bots) allowed.
Default: 10
Example:
api.php?action=query&list=exturlusage&euquery=www.mediawiki.org
Generator:
This module may be used as a generator
* list=users (us) *
Get information about a list of users
This module requires read rights.
Parameters:
usprop - What pieces of information to include
blockinfo - tags if the user is blocked, by whom, and for what reason
groups - lists all the groups the user belongs to
editcount - adds the user's edit count
registration - adds the user's registration timestamp
emailable - tags if the user can and wants to receive e-mail through [[Special:Emailuser]]
gender - tags the gender of the user. Returns "male", "female", or "unknown"
Values (separate with '|'): blockinfo, groups, editcount, registration, emailable, gender
ususers - A list of users to obtain the same information for
ustoken - Which tokens to obtain for each user
Values (separate with '|'): userrights
Example:
api.php?action=query&list=users&ususers=brion|TimStarling&usprop=groups|editcount|gender
* list=random (rn) *
Get a set of random pages
NOTE: 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.
NOTE: 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.
This module requires read rights.
Parameters:
rnnamespace - Return pages in these namespaces only
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rnlimit - Limit how many random pages will be returned
No more than 10 (20 for bots) allowed.
Default: 1
rnredirect - Load a random redirect instead of a random page
Example:
api.php?action=query&list=random&rnnamespace=0&rnlimit=2
Generator:
This module may be used as a generator
* list=protectedtitles (pt) *
List all titles protected from creation
This module requires read rights.
Parameters:
ptnamespace - Only list titles in these namespaces
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
ptlevel - Only list titles with these protection levels
Values (separate with '|'): autoconfirmed, sysop
ptlimit - How many total pages to return.
No more than 500 (5000 for bots) allowed.
Default: 10
ptdir - The direction in which to list
One value: older, newer
Default: older
ptstart - Start listing at this protection timestamp
ptend - Stop listing at this protection timestamp
ptprop - Which properties to get
Values (separate with '|'): timestamp, user, comment, parsedcomment, expiry, level
Default: timestamp|level
Example:
api.php?action=query&list=protectedtitles
Generator:
This module may be used as a generator
--- --- --- --- --- --- --- --- Query: Meta --- --- --- --- --- --- --- ---
* meta=siteinfo (si) *
Return general information about the site.
This module requires read rights.
Parameters:
siprop - Which sysinfo properties to get:
general - Overall system information
namespaces - List of registered namespaces and their canonical names
namespacealiases - List of registered namespace aliases
specialpagealiases - List of special page aliases
magicwords - List of magic words and their aliases
statistics - Returns site statistics
interwikimap - Returns interwiki map (optionally filtered)
dbrepllag - Returns database server with the highest replication lag
usergroups - Returns user groups and the associated permissions
extensions - Returns extensions installed on the wiki
fileextensions - Returns list of file extensions allowed to be uploaded
rightsinfo - Returns wiki rights (license) information if available
languages - Returns a list of languages MediaWiki supports
Values (separate with '|'): general, namespaces, namespacealiases, specialpagealiases, magicwords, interwikimap, dbrepllag, statistics, usergroups, extensions, fileextensions, rightsinfo, languages
Default: general
sifilteriw - Return only local or only nonlocal entries of the interwiki map
One value: local, !local
sishowalldb - List all database servers, not just the one lagging the most
sinumberingroup - Lists the number of users in user groups
Examples:
api.php?action=query&meta=siteinfo&siprop=general|namespaces|namespacealiases|statistics
api.php?action=query&meta=siteinfo&siprop=interwikimap&sifilteriw=local
api.php?action=query&meta=siteinfo&siprop=dbrepllag&sishowalldb
* meta=userinfo (ui) *
Get information about the current user
This module requires read rights.
Parameters:
uiprop - What pieces of information to include
blockinfo - tags if the current user is blocked, by whom, and for what reason
hasmsg - adds a tag "message" if the current user has pending messages
groups - lists all the groups the current user belongs to
rights - lists all the rights the current user has
changeablegroups - lists the groups the current user can add to and remove from
options - lists all preferences the current user has set
editcount - adds the current user's edit count
ratelimits - lists all rate limits applying to the current user
Values (separate with '|'): blockinfo, hasmsg, groups, rights, changeablegroups, options, preferencestoken, editcount, ratelimits, email
Examples:
api.php?action=query&meta=userinfo
api.php?action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg
* meta=allmessages (am) *
Return messages from this site.
This module requires read rights.
Parameters:
ammessages - Which messages to output. "*" means all messages
Default: *
amprop - Which properties to get
Values (separate with '|'): default
amenableparser - Set to enable parser, will preprocess the wikitext of message
Will substitute magic words, handle templates etc.
amargs - Arguments to be substituted into message
amfilter - Return only messages that contain this string
amlang - Return messages in this language
amfrom - Return messages starting at this message
Examples:
api.php?action=query&meta=allmessages&amfilter=ipb-
api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de
*** *** *** *** *** *** *** *** *** *** Modules: continuation *** *** *** *** *** *** *** *** *** ***
* action=expandtemplates *
This module expand all templates in wikitext
This module requires read rights.
Parameters:
title - Title of page
Default: API
text - Wikitext to convert
generatexml - Generate XML parse tree
Example:
api.php?action=expandtemplates&text={{Project:Sandbox}}
* action=parse *
This module parses wikitext and returns parser output
This module requires read rights.
Parameters:
title - Title of page the text belongs to
Default: API
text - Wikitext to parse
summary - Summary to parse
page - Parse the content of this page. Cannot be used together with text and title
redirects - If the page parameter is set to a redirect, resolve it
oldid - Parse the content of this revision. Overrides page
prop - Which pieces of information to get.
NOTE: Section tree is only generated if there are more than 4 sections, or if the __TOC__ keyword is present
Values (separate with '|'): text, langlinks, categories, links, templates, images, externallinks, sections, revid, displaytitle, headitems, headhtml
Default: text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle
pst - Do a pre-save transform on the input before parsing it.
Ignored if page or oldid is used.
onlypst - Do a PST on the input, but don't parse it.
Returns PSTed wikitext. Ignored if page or oldid is used.
Example:
api.php?action=parse&text={{Project:Sandbox}}
* action=opensearch *
This module implements OpenSearch protocol
This module requires read rights.
Parameters:
search - Search string
limit - Maximum amount of results to return
No more than 100 (100 for bots) allowed.
Default: 10
namespace - Namespaces to search
Values (separate with '|'): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Default: 0
suggest - Do nothing if $wgEnableOpenSearchSuggest is false
Example:
api.php?action=opensearch&search=Te
* action=feedwatchlist *
This module returns a watchlist feed
This module requires read rights.
Parameters:
feedformat - The format of the feed
One value: rss, atom
Default: rss
hours - List pages modified within this many hours from now
The value must be between 1 and 72
Default: 24
allrev - Include multiple revisions of the same page within given timeframe.
wlowner - The user whose watchlist you want (must be accompanied by wltoken if it's not you)
wltoken - Security token that requested user set in their preferences
Example:
api.php?action=feedwatchlist
* action=help *
Display this help screen.
* action=paraminfo *
Obtain information about certain API parameters
Parameters:
modules - List of module names (value of the action= parameter)
querymodules - List of query module names (value of prop=, meta= or list= parameter)
mainmodule - Get information about the main (top-level) module as well
pagesetmodule - Get information about the pageset module (providing titles= and friends) as well
Example:
api.php?action=paraminfo&modules=parse&querymodules=allpages|siteinfo
* action=purge *
Purge the cache for the given titles.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
titles - A list of titles
Example:
api.php?action=purge&titles=Main_Page|API
* action=rollback *
Undo the last edit to the page. If the last user who edited the page made multiple edits in a row,
they will all be rolled back.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
title - Title of the page you want to rollback.
user - Name of the user whose edits are to be rolled back. If set incorrectly, you'll get a badtoken error.
token - A rollback token previously retrieved through prop=revisions
summary - Custom edit summary. If not set, default summary will be used.
markbot - Mark the reverted edits and the revert as bot edits
Examples:
api.php?action=rollback&title=Main%20Page&user=Catrope&token=123ABC
api.php?action=rollback&title=Main%20Page&user=217.121.114.116&token=123ABC&summary=Reverting%20vandalism&markbot=1
* action=delete *
Delete a page.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
title - Title of the page you want to delete. Cannot be used together with pageid
pageid - Page ID of the page you want to delete. Cannot be used together with title
token - A delete token previously retrieved through prop=info
reason - Reason for the deletion. If not set, an automatically generated reason will be used.
watch - Add the page to your watchlist
unwatch - Remove the page from your watchlist
oldimage - The name of the old image to delete as provided by iiprop=archivename
Examples:
api.php?action=delete&title=Main%20Page&token=123ABC
api.php?action=delete&title=Main%20Page&token=123ABC&reason=Preparing%20for%20move
* action=undelete *
Restore certain revisions of a deleted page. A list of deleted revisions (including timestamps) can be
retrieved through list=deletedrevs
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
title - Title of the page you want to restore.
token - An undelete token previously retrieved through list=deletedrevs
reason - Reason for restoring (optional)
Default:
timestamps - Timestamps of the revisions to restore. If not set, all revisions will be restored.
Examples:
api.php?action=undelete&title=Main%20Page&token=123ABC&reason=Restoring%20main%20page
api.php?action=undelete&title=Main%20Page&token=123ABC×tamps=20070703220045|20070702194856
* action=protect *
Change the protection level of a page.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
title - Title of the page you want to (un)protect.
token - A protect token previously retrieved through prop=info
protections - Pipe-separated list of protection levels, formatted action=group (e.g. edit=sysop)
expiry - Expiry timestamps. If only one timestamp is set, it'll be used for all protections.
Use 'infinite', 'indefinite' or 'never', for a neverexpiring protection.
Default: infinite
reason - Reason for (un)protecting (optional)
Default:
cascade - Enable cascading protection (i.e. protect pages included in this page)
Ignored if not all protection levels are 'sysop' or 'protect'
watch - If set, add the page being (un)protected to your watchlist
Examples:
api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=sysop|move=sysop&cascade&expiry=20070901163000|never
api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=all|move=all&reason=Lifting%20restrictions
* action=block *
Block a user.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
user - Username, IP address or IP range you want to block
token - A block token previously obtained through the gettoken parameter or prop=info
gettoken - If set, a block token will be returned, and no other action will be taken
expiry - Relative expiry time, e.g. '5 months' or '2 weeks'. If set to 'infinite', 'indefinite' or 'never', the block will never expire.
Default: never
reason - Reason for block (optional)
anononly - Block anonymous users only (i.e. disable anonymous edits for this IP)
nocreate - Prevent account creation
autoblock - Automatically block the last used IP address, and any subsequent IP addresses they try to login from
noemail - Prevent user from sending e-mail through the wiki. (Requires the "blockemail" right.)
hidename - Hide the username from the block log. (Requires the "hideuser" right.)
allowusertalk - Allow the user to edit their own talk page (depends on $wgBlockAllowsUTEdit)
reblock - If the user is already blocked, overwrite the existing block
Examples:
api.php?action=block&user=123.5.5.12&expiry=3%20days&reason=First%20strike
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate&autoblock&noemail
* action=unblock *
Unblock a user.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
id - ID of the block you want to unblock (obtained through list=blocks). Cannot be used together with user
user - Username, IP address or IP range you want to unblock. Cannot be used together with id
token - An unblock token previously obtained through the gettoken parameter or prop=info
gettoken - If set, an unblock token will be returned, and no other action will be taken
reason - Reason for unblock (optional)
Examples:
api.php?action=unblock&id=105
api.php?action=unblock&user=Bob&reason=Sorry%20Bob
* action=move *
Move a page.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
from - Title of the page you want to move. Cannot be used together with fromid.
fromid - Page ID of the page you want to move. Cannot be used together with from.
to - Title you want to rename the page to.
token - A move token previously retrieved through prop=info
reason - Reason for the move (optional).
movetalk - Move the talk page, if it exists.
movesubpages - Move subpages, if applicable
noredirect - Don't create a redirect
watch - Add the page and the redirect to your watchlist
unwatch - Remove the page and the redirect from your watchlist
ignorewarnings - Ignore any warnings
Example:
api.php?action=move&from=Exampel&to=Example&token=123ABC&reason=Misspelled%20title&movetalk&noredirect
* action=edit *
Create and edit pages.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
title - Page title
section - Section number. 0 for the top section, 'new' for a new section
text - Page content
token - Edit token. You can get one of these through prop=info
summary - Edit summary. Also section title when section=new
minor - Minor edit
notminor - Non-minor edit
bot - Mark this edit as bot
basetimestamp - Timestamp of the base revision (gotten through prop=revisions&rvprop=timestamp).
Used to detect edit conflicts; leave unset to ignore conflicts.
starttimestamp - Timestamp when you obtained the edit token.
Used to detect edit conflicts; leave unset to ignore conflicts.
recreate - Override any errors about the article having been deleted in the meantime
createonly - Don't edit the page if it exists already
nocreate - Throw an error if the page doesn't exist
captchaword - Answer to the CAPTCHA
captchaid - CAPTCHA ID from previous request
watch - DEPRECATED! Add the page to your watchlist
unwatch - DEPRECATED! Remove the page from your watchlist
watchlist - Unconditionally add or remove the page from your watchlist, use preferences or do not change watch
One value: watch, unwatch, preferences, nochange
Default: preferences
md5 - The MD5 hash of the text parameter, or the prependtext and appendtext parameters concatenated.
If set, the edit won't be done unless the hash is correct
prependtext - Add this text to the beginning of the page. Overrides text.
appendtext - Add this text to the end of the page. Overrides text
undo - Undo this revision. Overrides text, prependtext and appendtext
undoafter - Undo all revisions from undo to this one. If not set, just undo one revision
Examples:
Edit a page (anonymous user):
api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&basetimestamp=20070824123454&token=%2B\
Prepend __NOTOC__ to a page (anonymous user):
api.php?action=edit&title=Test&summary=NOTOC&minor&prependtext=__NOTOC__%0A&basetimestamp=20070824123454&token=%2B\
Undo r13579 through r13585 with autosummary(anonymous user):
api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=20070824123454&token=%2B\
* action=upload *
Upload a file, or get the status of pending uploads. Several methods are available:
* Upload file contents directly, using the "file" parameter
* Have the MediaWiki server fetch a file from a URL, using the "url" parameter
* Complete an earlier upload that failed due to warnings, using the "sessionkey" parameter
Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when
sending the "file". Note also that queries using session keys must be
done in the same login session as the query that originally returned the key (i.e. do not
log out and then log back in). Also you must get and send an edit token before doing any upload stuff.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
filename - Target filename
comment - Upload comment. Also used as the initial page text for new files if "text" is not specified
Default:
text - Initial page text for new files
token - Edit token. You can get one of these through prop=info
watch - Watch the page
ignorewarnings - Ignore any warnings
file - File contents
url - Url to fetch the file from
sessionkey - Session key returned by a previous upload that failed due to warnings
Examples:
Upload from a URL:
api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png
Complete an upload that failed due to warnings:
api.php?action=upload&filename=Wiki.png&sessionkey=sessionkey&ignorewarnings=1
* action=emailuser *
Email a user.
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
target - User to send email to
subject - Subject header
text - Mail body
token - A token previously acquired via prop=info
ccme - Send a copy of this mail to me
Example:
api.php?action=emailuser&target=WikiSysop&text=Content
* action=watch *
Add or remove a page from/to the current user's watchlist
This module requires read rights.
This module requires write rights.
Parameters:
title - The page to (un)watch
unwatch - If set the page will be unwatched rather than watched
Examples:
api.php?action=watch&title=Main_Page
api.php?action=watch&title=Main_Page&unwatch
* action=patrol *
Patrol a page or revision.
This module requires read rights.
This module requires write rights.
Parameters:
token - Patrol token obtained from list=recentchanges
rcid - Recentchanges ID to patrol
Example:
api.php?action=patrol&token=123abc&rcid=230672766
* action=import *
Import a page from another wiki, or an XML file
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
token - Import token obtained through prop=info
summary - Import summary
xml - Uploaded XML file
interwikisource - For interwiki imports: wiki to import from
One value:
interwikipage - For interwiki imports: page to import
fullhistory - For interwiki imports: import the full history, not just the current version
templates - For interwiki imports: import all included templates as well
namespace - For interwiki imports: import to this namespace
One value: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Examples:
Import [[meta:Help:Parserfunctions]] to namespace 100 with full history:
api.php?action=import&interwikisource=meta&interwikipage=Help:ParserFunctions&namespace=100&fullhistory&token=123ABC
* action=userrights *
Add/remove a user to/from groups
This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Parameters:
user - User name
add - Add the user to these groups
Values (separate with '|'): bot, sysop, bureaucrat
remove - Remove the user from these groups
Values (separate with '|'): bot, sysop, bureaucrat
token - A userrights token previously retrieved through list=users
reason - Reason for the change
Default:
Example:
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC
*** *** *** *** *** *** *** *** *** *** Permissions *** *** *** *** *** *** *** *** *** ***
* writeapi *
Use of the write API
Granted to:
all, user, bot
* apihighlimits *
Use higher limits in API queries (Slow queries: 500 results; Fast queries: 5000 results). The limits for slow queries also apply to multivalue parameters.
Granted to:
bot, sysop
*** *** *** *** *** *** *** *** *** *** Formats *** *** *** *** *** *** *** *** *** ***
* format=json *
Output data in JSON format
This module requires read rights.
Parameters:
callback - If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=json
* format=jsonfm *
Output data in JSON format (pretty-print in HTML)
This module requires read rights.
Parameters:
callback - If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=jsonfm
* format=php *
Output data in serialized PHP format
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=php
* format=phpfm *
Output data in serialized PHP format (pretty-print in HTML)
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=phpfm
* format=wddx *
Output data in WDDX format
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddx
* format=wddxfm *
Output data in WDDX format (pretty-print in HTML)
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddxfm
* format=xml *
Output data in XML format
This module requires read rights.
Parameters:
xmldoublequote - If specified, double quotes all attributes and content.
xslt - If specified, adds <xslt> as stylesheet
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xml
* format=xmlfm *
Output data in XML format (pretty-print in HTML)
This module requires read rights.
Parameters:
xmldoublequote - If specified, double quotes all attributes and content.
xslt - If specified, adds <xslt> as stylesheet
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xmlfm
* format=yaml *
Output data in YAML format
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yaml
* format=yamlfm *
Output data in YAML format (pretty-print in HTML)
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yamlfm
* format=rawfm *
Output data with the debuging elements in JSON format (pretty-print in HTML)
This module requires read rights.
Parameters:
callback - If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=rawfm
* format=txt *
Output data in PHP's print_r() format
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txt
* format=txtfm *
Output data in PHP's print_r() format (pretty-print in HTML)
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txtfm
* format=dbg *
Output data in PHP's var_export() format
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbg
* format=dbgfm *
Output data in PHP's var_export() format (pretty-print in HTML)
This module requires read rights.
Example:
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbgfm
*** Credits: ***
API developers:
Roan Kattouw <Firstname>.<Lastname>@home.nl (lead developer Sep 2007-present)
Victor Vasiliev - vasilvv at gee mail dot com
Bryan Tong Minh - bryan . tongminh @ gmail . com
Sam Reed - sam @ reedyboy . net
Yuri Astrakhan <Firstname><Lastname>@gmail.com (creator, lead developer Sep 2006-Sep 2007)
Please send your comments, suggestions and questions to mediawiki-api@lists.wikimedia.org
or file a bug report at http://bugzilla.wikimedia.org/
</error>
</api>
