Get edit counts for a page in a project.

GET

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

Edits data

Given a Mediawiki project, a page-title prefixed with its canonical namespace (for
instance 'User:Jimbo_Wales') and a date range, returns a timeseries of edit counts.
You can filter by editors-type (all-editor-types, anonymous, group-bot, name-bot, user).
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/per-page//////'

Response Example

200 - Example 1

{
    "items": [
        {
            "editor-type": "string",
            "granularity": "string",
            "page-title": "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.

page-title

string

required

The page-title to request edits for. It should be prefixed with canonical namespace.
Spaces will be converted to underscores.

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.

granularity

string

required

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-title

string

optional

project

string

optional

results

array [object {2}]

optional

🔴500Error

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

Get edits counts for a project.

/metrics/legacy/pagecounts/aggregate/{project}/{access-site}/{granularity}/{start}/{end}