API:Feedrecentchanges

This page is part of the MediaWiki Action API documentation.

MediaWiki version:

≥ 1.23

GET request to return a recent changes feed.

API documentation

The following documentation is the output of Special:ApiHelp/feedrecentchanges, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

action=feedrecentchanges

(main | feedrecentchanges)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Returns a recent changes feed.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Feedrecentchanges

Specific parameters:

Other general parameters are available.

feedformat: The format of the feed.; One of the following values: atom, rss; Default: rss
namespace: Namespace to limit the results to.; One of the following values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 486, 487, 710, 711, 828, 829, 1198, 1199, 2600, 5500, 5501
invert: All namespaces but the selected one.; Type: boolean (details)
associated: Include associated (talk or main) namespace.; Type: boolean (details)
days: Days to limit the results to.; Type: integer; The value must be no less than 1.; Default: 7
limit: Maximum number of results to return.; Type: integer; The value must be between 1 and 50.; Default: 50
from: Show changes since then.; Type: timestamp (allowed formats)
hideminor: Hide minor changes.; Type: boolean (details)
hidebots: Hide changes made by bots.; Type: boolean (details)
hideanons: Hide changes made by anonymous users.; Type: boolean (details)
hideliu: Hide changes made by registered users.; Type: boolean (details)
hidepatrolled: Hide patrolled changes.; Type: boolean (details)
hidemyself: Hide changes made by the current user.; Type: boolean (details)
hidecategorization: Hide category membership changes.; Type: boolean (details)
tagfilter: Filter by tag.
inverttags: All edits except ones tagged with the selected ones.; Type: boolean (details)
target: Show only changes on pages linked from this page.
showlinkedto: Show changes on pages linked to the selected page instead.; Type: boolean (details)

Examples:

Show recent changes.: api.php?action=feedrecentchanges [open in sandbox]
Show recent changes for 30 days.: api.php?action=feedrecentchanges&days=30 [open in sandbox]

Example

Show recent changes as an RSS feed.

api.php?action=feedrecentchanges&format=json [try in ApiSandbox]

Response

<rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
  <channel>
    <title>MediaWiki - Recent changes [en]</title>
    <link>
      https://www.mediawiki.org/wiki/Special:RecentChanges
    </link>
    <description>
      Track the most recent changes to the wiki in this feed.
    </description>
    <language>en</language>
    <generator>MediaWiki 1.27.0-wmf.6</generator>
    <lastBuildDate>Thu, 12 Nov 2015 22:55:31 GMT</lastBuildDate>
    <item>
      <title>Reading/Component responsibility</title>
      <link>
        https://www.mediawiki.org/w/index.php?title=Reading/Component_responsibility&diff=1937428&oldid=1937427
      </link>
      <guid isPermaLink="false">
        https://www.mediawiki.org/w/index.php?title=Reading/Component_responsibility&diff=1937428&oldid=1937427
      </guid>
      <description>
        ...
      </description>
      <pubDate>Thu, 12 Nov 2015 20:42:06 GMT</pubDate>
      <dc:creator>Salawad</dc:creator>
      <comments>https://www.mediawiki.org/wiki/User_talk:Salawad</comments>
    </item>
  </channel>
</rss>

Sample code

Python

#!/usr/bin/python3

"""
    get_feed_recent_changes.py

    MediaWiki API Demos
    Demo of `Feedrecentchanges` module: Show recent changes as an RSS feed.

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action": "feedrecentchanges",
    "format": "json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.content

print(DATA)

PHP

<?php
/*
    get_feed_recent_changes.php

    MediaWiki API Demos
    Demo of `Feedrecentchanges` module: Show recent changes as an RSS feed.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "feedrecentchanges",
    "format" => "json"
];

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

var_dump( $output );

JavaScript

/*
    get_feed_recent_changes.js

    MediaWiki API Demos
    Demo of `Feedrecentchanges` module: Show recent changes as an RSS feed.

    MIT License
*/

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "feedrecentchanges",
    format: "json"
};

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

fetch(url)
    .then(function(response){return response.json();})
    .then(function(response) {console.log(response);})
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	get_feed_recent_changes.js

	MediaWiki API Demos
	Demo of `Feedrecentchanges` module: Show recent changes as an RSS feed.

	MIT License
*/

var params = {
		action: 'feedrecentchanges',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	console.log( data );
} );

Possible errors

In addition to the standard error messages:

Code	Info
feed-unavailable	Syndication feeds are not available
feed-invalid	Invalid subscription feed type.
invalidtitle	Bad title "$1".

Parameter history

v1.28: Introduced hidecategorization

Additional notes

Note that if the request is successful, the output will be in the format requested by the feedformat parameter. The format requested by the standard format parameter (e.g., JSON) will only be used in the event of an error.