Get pageview counts for a project.

GET

/metrics/pageviews/aggregate/{project}/{access}/{agent}/{granularity}/{start}/{end}

Pageviews data

Given a date range, returns a timeseries of pageview counts. You can filter by project,
access method and/or agent type. You can choose between daily and hourly granularity
as well.

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

Response Example

200 - Example 1

{
    "items": [
        {
            "access": "string",
            "agent": "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'.
If you are interested in all pageviews regardless of project, use all-projects.

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 or spider. If you are interested
in pageviews regardless of agent type, use all-agents.

granularity

string

required

The time unit for the response data. As of today, the supported granularities for this
endpoint are hourly, daily, and monthly.

start

string

required

The timestamp of the first hour/day/month to include, in YYYYMMDDHH format

end

string

required

The timestamp of the last hour/day/month to include, in YYYYMMDDHH format

Responses

🟢200The list of values

application/json

Body

items

array [object {6}]

optional

access

string

optional

agent

string

optional

granularity

string

optional

project

string

optional

timestamp

string

optional

views

integer <int64>

optional

🔴500Error

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

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

Get pageview counts for a page.