From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Usercontribs and the translation is 52% complete.

Other languages:
English • ‎dansk • ‎español • ‎français • ‎polski • ‎中文 • ‎日本語
Versión de MediaWiki: 1.9

GET request to list a user's contributions.

API documentation

list=usercontribs (uc)

(main | query | usercontribs)

Get all edits by a user.


The maximum number of contributions to return.

No more than 500 (5,000 for bots) allowed.
Type: integer or max
Default: 10

The start timestamp to return from.

Type: timestamp (allowed formats)

The end timestamp to return to.

Type: timestamp (allowed formats)

When more results are available, use this to continue.


The users to retrieve contributions for. Cannot be used with ucuserids or ucuserprefix.

Type: list of user names
Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

The user IDs to retrieve contributions for. Cannot be used with ucuser or ucuserprefix.

Type: list of integers
Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

Retrieve contributions for all users whose names begin with this value. Cannot be used with ucuser or ucuserids.


In which direction to enumerate:

List oldest first. Note: ucstart has to be before ucend.
List newest first (default). Note: ucstart has to be later than ucend.
One of the following values: newer, older
Default: older

Only list contributions in these namespaces.

Values (separate with | or alternative): 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, 828, 829, 1198, 1199, 2300, 2301, 2302, 2303, 2600, 5500, 5501
To specify all values, use *.

Include additional pieces of information:

Adds the page ID and revision ID.
Adds the title and namespace ID of the page.
Adds the timestamp of the edit.
Adds the comment of the edit.
Adds the parsed comment of the edit.
Adds the new size of the edit.
Adds the size delta of the edit against its parent.
Adds flags of the edit.
Tags patrolled edits.
Lists tags for the edit.
Values (separate with | or alternative): ids, title, timestamp, comment, parsedcomment, size, sizediff, flags, patrolled, tags
Default: ids|title|timestamp|comment|size|flags

Show only items that meet these criteria, e.g. non minor edits only: ucshow=!minor.

If ucshow=patrolled or ucshow=!patrolled is set, revisions older than $wgRCMaxAge (2592000 seconds) won't be shown.

Values (separate with | or alternative): minor, !minor, patrolled, !patrolled, autopatrolled, !autopatrolled, top, !top, new, !new

Only list revisions tagged with this tag.


Only list changes which are the latest revision.

Type: boolean (details)
Show contributions of user Example.
api.php?action=query&list=usercontribs&ucuser=Example [open in sandbox]
Show contributions from all IP addresses with prefix 192.0.2..
api.php?action=query&list=usercontribs&ucuserprefix=192.0.2. [open in sandbox]


GET request

List contributions by User:Jimbo Wales


    "batchcomplete": "",
    "continue": {
        "uccontinue": "20190130180447|880978627",
        "continue": "-||"
    "query": {
        "usercontribs": [
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9870625,
                "revid": 881893498,
                "parentid": 881892978,
                "ns": 3,
                "title": "User talk:Jimbo Wales",
                "timestamp": "2019-02-05T14:05:11Z",
                "comment": "/* Fancy I edit Wikipedia T-Shirt */",
                "size": 29753
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9870625,
                "revid": 881282261,
                "parentid": 881270759,
                "ns": 3,
                "title": "User talk:Jimbo Wales",
                "timestamp": "2019-02-01T15:29:31Z",
                "comment": "/* Macedonian President Gorge Ivanov is now in the House arrest */",
                "size": 60166
                "userid": 24,
                "user": "Jimbo Wales",
                "pageid": 9513191,
                "revid": 881245934,
                "parentid": 881240310,
                "ns": 1,
                "title": "Talk:Mark Dice",
                "timestamp": "2019-02-01T09:48:38Z",
                "comment": "/* So good they names it twice */",
                "size": 74128

Sample code




    MediaWiki Action API Code Samples
    Demo of `Usercontribs` module: List contributions by
    a user.
    MIT license

import requests

S = requests.Session()

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

    "ucuser":"Jimbo Wales"

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


Possible errors

Código Información
invaliduserid El identificador de usuario username no es válido.
paramempty_ucuser El parámetro user no puede estar vacío.
baduser_ucuser Valor no válido "username" para el parámetro de usuario user.
show Parámetro incorrecto: no se pueden proporcionar valores mutuamente excluyentes.
permissiondenied You need the patrol or patrolmarks right to request the patrolled flag.

Parameter history

  • v1.29: Introducido ucuserids
  • v1.23: Deprecated uctoponly
  • v1.23: Introducido ucshow=top, ucshow=!top, ucshow=new, ucshow=!new
  • v1.20: Introducido ucprop=sizediff
  • v1.18: Introducido uctoponly
  • v1.16: Introducido ucprop=parsedcomment, ucprop=size, ucprop=tags, uctag
  • v1.15: Introducido ucprop=patrolled, ucshow=patrolled, ucshow=!patrolled
  • v1.14: Introducido uccontinue
  • v1.13: Introducido ucuserprefix
  • v1.11: Introducido ucnamespace, ucprop, ucshow

Notas adicionales

  • The module returns page edits and moves, but not other operations, such as uploads.
  • Prior to MediaWiki v1.14, the start parameter was used to view additional results within the response. Between v1.14 and v1.22, start was used to continue when listing a single user's contributions; continue was used when listing contributions from multiple users. From v1.23 forwards, all queries use continue.

Véase también