API:Watch

This page is part of the MediaWiki API documentation.

Language:	English  • Deutsch

MediaWiki API

Quick overview:

• Quick start guide
• FAQ
  • Etiquette and usage limits
• Tutorial
• Formats
• Error reporting
• Restricting usage
• Authentication
  • Login
  • Logout
• Queries
  • Meta information
  • Properties
  • Lists
• Search suggestions
• Expanding templates and rendering
• 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
  • Send e-mail
  • Patrol changes
  • Import pages
  • Change user group membership
  • Upload files
  • User options
• Watchlist feed
• Extensions
• Using the API in MediaWiki and extensions
• Miscellaneous
• Implementation
• Client code

MediaWiki version:

1.18

Token

To (un)watch a page, a token is required. This token is different to the edit token, is the same for all pages, but changes at every login. A(n) (un)watch token can be obtained like this: Obtaining a watch token

api.php ? action=query & prop=info & intoken=watch & titles=Main%20Page

<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="1" ns="0" title="Main Page" touched="2012-02-07T17:27:37Z" lastrevid="2"
        counter="21" length="440" starttimestamp="2012-02-09T18:03:17Z"
        watchtoken="f2583b3edcdc2142f7256be161764d91+\" />
    </pages>
  </query>
</api>

Watching and unwatching pages

Pages can be watched (added to your watchlist) and unwatched (removed from your watchlist) with action=watch. Of course, you can only add and remove pages to/from your own watchlist.

Parameters

• title: Page to (un)watch
• unwatch: If set, unwatch the page. If not set, watch the page.
• token: Your (un)watch token.

Examples

Watching Main Page

api.php ? action=watch & title=Main_Page & token=f2583b3edcdc2142f7256be161764d91%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <watch title="Main Page" watched="" />
</api>

Unwatching Dog

api.php ? action=watch & title=Dog & unwatch & token=f2583b3edcdc2142f7256be161764d91%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <watch title="Dog" unwatched="" />
</api>

Possible errors

Only the usual stuff.