Get pageviews by country and access method.

GET

/metrics/pageviews/top-by-country/{project}/{access}/{year}/{month}

Pageviews data

Lists the pageviews to this project, split by country of origin for a given month.
Because of privacy reasons, pageviews are given in a bucketed format, and countries
with less than 100 views do not get reported.
Stability: experimental

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/top-by-country////'

Response Example

200 - Example 1

{
    "items": [
        {
            "access": "string",
            "countries": [
                {
                    "country": "string",
                    "rank": 0,
                    "views": 0
                }
            ],
            "month": "string",
            "project": "string",
            "year": "string"
        }
    ]
}

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.

year

string

required

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

month

string

required

The month of the date for which to retrieve top countries, in MM format.

Responses

🟢200The list of top countries by pageviews in the project

application/json

Body

items

array [object {5}]

optional

access

string

optional

countries

array [object {3}]

optional

month

string

optional

project

string

optional

year

string

optional

🔴500Error

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

Get pageview counts for a page.

Get the most viewed articles for a project.