MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/API
prop=revisions (rv)
- This module requires read rights.
- This module can be used as a generator.
Get revision information.
May be used in several ways:
- Get data about a set of pages (last revision), by setting titles or pageids.
- Get revisions for one given page, by using titles or pageids with start, end, or limit.
- Get data about a set of revisions by setting their IDs with revids.
- rvprop
Which properties to get for each revision:
- ids
- The ID of the revision.
- flags
- Revision flags (minor).
- timestamp
- The timestamp of the revision.
- user
- User that made the revision.
- userid
- User ID of the revision creator.
- size
- Length (bytes) of the revision.
- sha1
- SHA-1 (base 16) of the revision.
- contentmodel
- Content model ID of the revision.
- comment
- Comment by the user for the revision.
- parsedcomment
- Parsed comment by the user for the revision.
- content
- Text of the revision.
- tags
- Tags for the revision.
- Values (separate with "|"): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags
- Default: ids|timestamp|flags|comment|user
- rvlimit
Limit how many revisions will be returned.
- May only be used with a single page (mode #2).
- No more than 500 (5,000 for bots) allowed.
- rvexpandtemplates
Expand templates in revision content (requires rvprop=content).
- rvgeneratexml
Generate XML parse tree for revision content (requires rvprop=content).
- rvparse
Parse revision content (requires rvprop=content). For performance reasons, if this option is used, rvlimit is enforced to 1.
- rvsection
Only retrieve the content of this section number.
- 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 rvdiffto. If rvsection is set, only that section will be diffed against this text
- rvcontentformat
Serialization format used for rvdifftotext and expected for output of content.
- One value: text/x-wiki, text/javascript, application/json, text/css, text/plain
- rvstartid
From which revision ID to start enumeration.
- May only be used with a single page (mode #2).
- rvendid
Stop revision enumeration on this revision ID.
- May only be used with a single page (mode #2).
- rvstart
From which revision timestamp to start enumeration.
- May only be used with a single page (mode #2).
- rvend
Enumerate up to this timestamp.
- May only be used with a single page (mode #2).
- rvdir
In which direction to enumerate:
- newer
- List oldest first. Note: rvstart has to be before rvend.
- older
- List newest first (default). Note: rvstart has to be later than rvend.
- May only be used with a single page (mode #2).
- One value: newer, older
- Default: older
- rvuser
Only include revisions made by user.
- May only be used with a single page (mode #2).
- rvexcludeuser
Exclude revisions made by user.
- May only be used with a single page (mode #2).
- rvtag
Only list revisions tagged with this tag.
- rvtoken
- Deprecated.
Which tokens to obtain for each revision.
- Values (separate with "|"): rollback
- rvcontinue
When more results are available, use this to continue.
- 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=2006-05-01T00:00:00Z
- Get first 5 revisions of the "Main Page" that were not 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