API:Watchlist

This page is part of the MediaWiki API documentation.

MediaWiki API

Quick overview:

• Quick start guide
• FAQ
  • Etiquette and usage limits
• Tutorial
• Formats
• Error reporting
• Restricting usage
• Cross-site requests
• Authentication
  • Login
  • Logout
  • Account creation
• Queries
  • Meta information
  • Properties
  • Lists
• Search suggestions
• Parsing wikitext and expanding templates
• Purging pages' caches
• Parameter information
• Changing wiki content
  • Create and edit pages
  • Move pages
  • Rollback
  • Delete pages
  • Restore deleted revisions
  • (Un)protect pages
  • (Un)block users
  • (Un)watch pages
  • Mark revisions of watched pages as visited
  • Send email
  • Patrol changes
  • Import pages
  • Change user group membership
  • Upload files
  • User options
  • Tokens
  • Page language
• Watchlist feed
• Wikidata
• Extensions
• Using the API in MediaWiki and extensions
• Miscellaneous
• Implementation
• Client code
• Asserting

watchlist / wl

MediaWiki version:

1.11

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

Parameters

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

Example

Get the current user's watchlist

api.php?action=query&list=watchlist

Possible errors

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