Get top 100 editors by net bytes-difference.

GET

/metrics/editors/top-by-net-bytes-difference/{project}/{editor-type}/{page-type}/{year}/{month}/{day}

Editors data

Given a Mediawiki project and a date (day or month), returns a timeseries of the top 100
editors by net bytes-difference. You can filter by editor-type (all-editor-types, anonymous,
group-bot, name-bot, user) or page-type (all-page-types, content or non-content). The
user_text returned is either the mediawiki user_text if the user is registered, or
"Anonymous Editor" if user is anonymous.

Stability: experimental

Rate limit: 25 req/s

License: Data accessible via this endpoint is available under the
CC0 1.0 license.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://wikimedia.org/api/rest_v1/metrics/editors/top-by-net-bytes-difference//////'

Response Example

200 - Example 1

{
    "items": [
        {
            "editor-type": "string",
            "granularity": "string",
            "page-type": "string",
            "project": "string",
            "results": [
                {
                    "timestamp": "string",
                    "top": [
                        {
                            "net_bytes_diff": 0,
                            "rank": 0,
                            "user_text": "string"
                        }
                    ]
                }
            ]
        }
    ]
}

Request

Path Params

project

string

required

The name of any Wikimedia project formatted like {language code}.{project name},
for example en.wikipedia. You may pass en.wikipedia.org and the .org will be stripped
off. For projects like commons without language codes, use commons.wikimedia. For
projects like www.mediawiki.org, you can use that full string, or just use mediawiki
or mediawiki.org.

editor-type

string

required

If you want to filter by editor-type, use one of anonymous, group-bot (registered
accounts belonging to the bot group), name-bot (registered accounts not belonging to
the bot group but having bot-like names) or user (registered account not in bot group
nor having bot-like name). If you are interested in edits regardless of their
editor-type, use all-editor-types.

page-type

string

required

If you want to filter by page-type, use one of content (edits on pages in content
namespaces) or non-content (edits on pages in non-content namespaces). If you are
interested in edits regardless of their page-type, use all-page-types.

year

string

required

The year of the date for which to retrieve top editors, in YYYY format.

month

string

required

The month of the date for which to retrieve top editors, in MM format. If you want to get the top editors of a whole month, the day parameter should be all-days.

day

string

required

The day of the date for which to retrieve top editors, in DD format, or all-days for a monthly value.

Responses

🟢200The list of values

application/json

Body

items

array [object {5}]

optional

editor-type

string

optional

granularity

string

optional

page-type

string

optional

project

string

optional

results

array [object {2}]

optional

🔴500Error

Modified at 2023-08-15 06:49:12

Get top 100 editors by edits count.

Get edits counts for a project.