Get pageview counts for a page.

GET

/metrics/pageviews/per-article/{project}/{access}/{agent}/{article}/{granularity}/{start}/{end}

Pageviews data

Given a Mediawiki article and a date range, returns a daily timeseries of its pageview
counts. You can also filter by access method and/or agent type.

Stability: stable

Rate limit: 100 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/pageviews/per-article///////'

Response Example

200 - Example 1

{
    "items": [
        {
            "access": "string",
            "agent": "string",
            "article": "string",
            "granularity": "string",
            "project": "string",
            "timestamp": "string",
            "views": 0
        }
    ]
}

Request

Path Params

project

string

required

If you want to filter by project, use the domain of any Wikimedia project,
for example 'en.wikipedia.org', 'www.mediawiki.org' or 'commons.wikimedia.org'.

access

string

required

If you want to filter by access method, use one of desktop, mobile-app
or mobile-web. If you are interested in pageviews regardless of access method,
use all-access.

agent

string

required

If you want to filter by agent type, use one of user, bot or spider. If you are
interested in pageviews regardless of agent type, use all-agents.

article

string

required

'The title of any article in the specified project. Any spaces should be replaced
with underscores. It also should be URI-encoded, so that non-URI-safe characters like
%, / or ? are accepted. Example: Are_You_the_One%3F'.

granularity

string

required

The time unit for the response data. As of today, the only supported granularity for
this endpoint is daily and monthly.

start

string

required

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

end

string

required

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

Responses

🟢200The list of values

application/json

Body

items

array [object {7}]

optional

access

string

optional

agent

string

optional

article

string

optional

granularity

string

optional

project

string

optional

timestamp

string

optional

views

integer <int64>

optional

🔴500Error

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

Get pageview counts for a project.

Get pageviews by country and access method.