XTools/API

The XTools features a rich API for much of the data available through the web interface. Out of courtesy we ask you make requests synchronously – as in one full round trip – before making a new request. Please leave an informative user agent in your request so we can contact you if we need to.

Interactive Open API docs are available at https://xtools.wmcloud.org/api.

Errors and warnings
Error messages are in the format specified by RFC 7807, with at minimum,   and   properties.

Please log any responses with a  property as this will announce deprecations and future changes.

To ensure performance and stability, most endpoints related to users will return a 501 response code if the user has made an exceptionally high number of edits. In the future, requests for such users may be permitted but will require authentication.

OpenAPI Specification
Version 3.18.0 introduced the first OpenAPI Specification of the XTools API. For the sake of consistency, many of the endpoints now have new standardized responses, and a few endpoints have been renamed or removed. XTools 3.18.0 was released on July 10, 2023.

Here is a summary of the breaking changes:

Common to all APIs


 * All  properties are now named.
 * All  properties are now named , and this returns a boolean, not an integer.
 * All  properties are now named.

Project API


 * The  and   endpoints have been removed. Use ,   and   instead.
 * The  endpoint results are now nested under the   property.

Page API


 * The  endpoint is removed. Use   instead.
 * The  endpoint results are now nested under the   property.

User API


 * The  endpoint has been removed. Use   instead.
 * The  endpoint now always groups results by namespace, even if a specific namespace was provided. Before, it only grouped by namespace if   was provided as the value for the   parameter.
 * The  endpoint
 * Now always groups results by namespace, even if a specific namespace was provided. Before, it only grouped by namespace if  was provided as the value for the   parameter.
 * Each page has the properties  (whether the page is deleted or not), ,  ,  ,   (boolean),  ,  ,  ,   (current length of the page),  , and   (with keys  ,  ,   and  ).
 * property is no longer included, as this represents the importance level of only a single WikiProjects and not the page overall.
 * and  properties are removed. Use   instead and do your own formatting as desired.
 * property has been removed.
 * The  endpoint
 * Now returns the  property instead of.
 * The  property is replaced by , which has the keys  ,  ,   and.
 * The  property has been removed.
 * The  property is now a boolean instead of an integer.
 * The  property is now a boolean instead of an integer.

Errors


 * All fatal errors (not warnings) are in the format specified by RFC 7807, with at minimum,   and   properties. Warnings are still be an array under the   property.

Endpoints

 * Project API
 * Normalize project
 * Namespaces
 * Page assessments
 * Page assessments configuration
 * Automated tools
 * Admins and user groups
 * Admin statistics
 * Patroller statistics
 * Steward statistics
 * Largest pages
 * User API
 * Simple edit count
 * Number of pages created
 * Pages created
 * Automated edit counter
 * Non-automated edits
 * Automated edits
 * Automated tools
 * Edit summaries
 * Top edits
 * Category edit counter
 * Log counts
 * Namespace totals
 * Month counts
 * Time card
 * Page API
 * Article info
 * Prose
 * Links
 * Top editors
 * Assessments
 * Bot data
 * (Semi-)automated edits
 * Quote API
 * Random quote
 * Single quote
 * All quotes