Wikipedia hub

Wikipedia Top Pages API

The most-viewed pages of a day, or the countries viewing an edition most in a month.

GET /v1/wikipedia/pageviews/top

1 credit Failed requests are free

About this endpoint

GET /v1/wikipedia/pageviews/top?lang=en&date=2026-11-02 returns data.articles ranked by views. Each row has article, project, views, viewsCeil and rank. When only a rounded bucket is available, viewsCeil holds the rounded-up number.

Set mode=countries with a month such as date=2026-10 to rank the countries that viewed the edition most. Rows then land in data.countries, with country, the views bucket, viewsCeil and rank. access is all-access, desktop, mobile-app or mobile-web in either mode. The article list is what the edition publishes as most-viewed, so it can include the main page, special pages and project pages, not only articles; project and viewsCeil are null on most rows.

With mode=articles, country=US ranks that country's articles instead of the global list. country cannot be combined with mode=countries. Dates must match the mode: YYYY-MM-DD for articles and YYYY-MM for countries.

Wikipedia Top Pages API FAQ

Which date format does each mode use?

mode=articles takes a day such as 2026-11-02. mode=countries takes a month such as 2026-10. A date in the wrong format is a 400, and the default is the latest published list: the previous day or month once it is out, and the one before until then.

How do I get one country's top articles?

Use mode=articles with country set to a two-letter code, for example country=US. That ranks the articles viewed from that country. country is not accepted with mode=countries.

Why is viewsCeil present?

Some rows only publish a rounded-up bucket rather than an exact count. views holds the exact count when it exists, and viewsCeil holds the upper bound when the row is bucketed.

How many credits does the top list cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.