> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/wikipedia/pageviews-top>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/wikipedia/pageviews-top.mdx>

---

# 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?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.

## Request

- **Endpoint:** `GET /v1/wikipedia/pageviews/top`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by day or month
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/wikipedia/pageviews/top/get)
- **Platform page:** [/platforms/wikipedia](https://www.socialfetch.dev/platforms/wikipedia)

## 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.