API:Feedcontributions

This page is part of the MediaWiki Action API documentation.

MediaWiki version:

≥ 1.18

GET request to return a user's contributions feed.

API documentation

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

action=feedcontributions

(main | feedcontributions)

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

Returns a user's contributions feed.

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

Specific parameters:

Other general parameters are available.

feedformat: The format of the feed.; One of the following values: atom, rss; Default: rss
user: What users to get the contributions for.; This parameter is required.; Type: user, by any of username, IP, Temporary user, IP range, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
namespace: Which namespace to filter the contributions by.; 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
year: From year (and earlier).; Type: integer
month: From month (and earlier).; Type: integer
tagfilter: Filter contributions that have these tags.; Values (separate with | or alternative): ASCII text added, AWB, Added PHP closing tag, Blocked user editing own talk page, Emoji, New user editing project page, OAuth CID: 21, OAuth CID: 31, OAuth CID: 429, OAuth CID: 1188, OAuth CID: 1261, OAuth CID: 1352, OAuth CID: 1805, OAuth CID: 1809, OAuth CID: 1841, OAuth CID: 2071, OAuth CID: 4458, OAuth CID: 4664, OAuth CID: 6365, OTRS permission added by non-OTRS member, Potentially problematic translation, Rapid reverts, T144167, abusefilter-condition-limit, advanced mobile edit, android app edit, app-ai-assist, app-description-add, app-description-change, app-description-translate, app-full-source, app-image-add-infobox, app-image-add-top, app-image-caption-add, app-image-caption-translate, app-image-tag-add, app-rollback, app-section-source, app-select-source, app-suggestededit, app-talk-reply, app-talk-source, app-talk-topic, app-undo, centralnotice, centralnotice translation, convenient-discussions, deletion template removed, disambiguator-link-added, discussiontools, discussiontools-added-comment, discussiontools-edit, discussiontools-newtopic, discussiontools-reply, discussiontools-source, discussiontools-source-enhanced, discussiontools-visual, editcheck-newcontent, editcheck-newreference, editcheck-reference-decline-common-knowledge, editcheck-reference-decline-irrelevant, editcheck-reference-decline-other, editcheck-reference-decline-uncertain, editcheck-references, editcheck-references-activated, emoji, fileimporter-remote, ios app edit, massmessage-delivery, meta spam id, mobile app edit, mobile edit, mobile web edit, mw-blank, mw-changed-redirect-target, mw-contentmodelchange, mw-manual-revert, mw-new-redirect, mw-removed-redirect, mw-replace, mw-reverted, mw-rollback, mw-server-side-upload, mw-undo, nuke, possible link spam 2, repeated xwiki CoI abuse, repeating characters, translate-translation-pages, visualeditor, visualeditor-needcheck, visualeditor-switched, visualeditor-wikitext, wikieditor, wikilove; Maximum number of values is 50 (500 for clients that are allowed higher limits).; Default: (empty)
deletedonly: Show only deleted contributions.; Type: boolean (details)
toponly: Only show edits that are the latest revisions.; Type: boolean (details)
newonly: Only show edits that are page creations.; Type: boolean (details)
hideminor: Hide minor edits.; Type: boolean (details)
showsizediff: Disabled due to miser mode.; Type: boolean (details)

Example:

Return contributions for user Example.: api.php?action=feedcontributions&user=Example [open in sandbox]

Example

GET request

Show contributions of a user as an RSS feed.

api.php?action=feedcontributions&user=Jimbo%20Wales&format=json [try in ApiSandbox]

Response

<rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
  <channel>
    <title>Wikipedia - User contributions [en]</title>
    <link>
      https://en.wikipedia.org/wiki/Special:Contributions/Jimbo_Wales
    </link>
    <description>User contributions</description>
    <language>en</language>
    <generator>MediaWiki 1.27.0-wmf.5</generator>
    <lastBuildDate>Wed, 11 Nov 2015 20:56:27 GMT</lastBuildDate>
    <item>
      <title>User talk:Jimbo Wales</title>
      <link>
        https://en.wikipedia.org/w/index.php?title=User_talk:Jimbo_Wales&diff=###
      </link>
      <guid isPermaLink="false">
        https://en.wikipedia.org/w/index.php?title=User_talk:Jimbo_Wales&diff=###
      </guid>
      <description>
        ...
      </description>
      <comments>
        https://en.wikipedia.org/wiki/User_talk:Jimbo_Wales
      </comments>
    </item>
  </channel>
</rss>

Sample code

Python

#!/usr/bin/python3

"""
    get_user_contributions_feed.py

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "feedcontributions",
    "user": "Jimbo Wales",
    "format": "json"
}

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

print(DATA)

PHP

<?php
/*
    get_user_contributions_feed.php

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "feedcontributions",
    "user" => "Jimbo Wales",
    "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_user_contributions_feed.js

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
*/

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

var params = {
    action: "feedcontributions",
    user: "Jimbo Wales",
    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_user_contributions_feed.js

	MediaWiki API Demos
	Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

	MIT License
*/

var params = {
		action: 'feedcontributions',
		user: 'Jimbo Wales',
		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.
sizediffdisabled	Size difference is disabled in Miser Mode.

Parameter history

v1.28: Introduced hideminor
v1.23: Introduced newonly

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.