Wikimedia

Get the most viewed articles for a project.

GET

/metrics/pageviews/top/{project}/{access}/{year}/{month}/{day}

Pageviews data

Lists the 1000 most viewed articles for a given project and timespan (month or day).
You can filter by access method.

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

Response Example

200 - Example 1

{
    "items": [
        {
            "access": "string",
            "articles": [
                {
                    "article": "string",
                    "rank": 0,
                    "views": 0
                }
            ],
            "day": "string",
            "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 articles, in YYYY format.

month

string

required

The month of the date for which to retrieve top articles, in MM format. If you want
to get the top articles of a whole month, the day parameter should be all-days.

day

string

required

The day of the date for which to retrieve top articles, in DD format.

Responses

🟢200The list of top articles in the project

application/json

Body

items

array [object {6}]

optional

access

string

optional

articles

array [object {3}]

optional

day

string

optional

month

string

optional

project

string

optional

year

string

optional

🔴500Error

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

Get pageviews by country and access method.

Get newly registered users counts for a project.