Get edits counts for a project.

GET

/metrics/edits/aggregate/{project}/{editor-type}/{page-type}/{granularity}/{start}/{end}

Edits data

Given a Mediawiki project and a date range, returns a timeseries of edits counts.
You can filter by editors-type (all-editor-types, anonymous, bot, registered) and
page-type (all-page-types, content or non-content). You can choose between daily and
monthly granularity as well.

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/edits/aggregate//////'

Response Example

200 - Example 1

{
    "items": [
        {
            "editor-type": "string",
            "granularity": "string",
            "page-type": "string",
            "project": "string",
            "results": [
                {
                    "edits": 0,
                    "timestamp": "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. If you're interested in the aggregation of
all projects, use all-projects.

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.

granularity

string

required

The time unit for the response data. As of today, supported values are
daily and monthly.

start

string

required

The date of the first day to include, in YYYYMMDD format

end

string

required

The date of the last day to include, in YYYYMMDD format

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 net bytes-difference.

Get edit counts for a page in a project.