# Wikipedia Pageviews API

> Daily or monthly page views of any Wikipedia article and the most-read articles of a day

- Vendor: `wikipediapageviewsapi` · version 1.0 · category Analytics · tags wikipedia pageviews api, page views api, trending topics api, wikipedia traffic api, top articles api, attention data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/wikipediapageviewsapi
- This document: https://apiclay.com/docs/wikipediapageviewsapi.md
- OpenAPI 3.1: https://apiclay.com/api/wikipediapageviewsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `wikipediapageviewsapi`
- Updated: 2026-11-18

## About

## Wikipedia Pageviews API

Traffic data from the Wikimedia REST API: daily or monthly page views of any article on any Wikipedia (desktop, mobile, all), and the top 1,000 most-read articles of a project on a given day.

Data comes from **wikimedia.org** (https://wikimedia.org/api/rest_v1/). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/article?project=en.wikipedia&amp;article=Alan_Turing&amp;granularity=daily&amp;start=20261101&amp;end=20261110`, `/top?project=en.wikipedia&amp;year=2026&amp;month=11&amp;day=10`.

### Routes

#### GET `/article` - Article views
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| project | path | string | yes | e.g. `en.wikipedia`, `de.wikipedia`. |
| article | path | string | yes | Title with underscores. |
| granularity | path | string | yes | `daily` or `monthly`. |
| start | path | string | yes | `YYYYMMDD`. |
| end | path | string | yes | `YYYYMMDD`. |

Returns: `items[]` with `timestamp`, `views`.

#### GET `/top` - Top articles
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| project | path | string | yes | e.g. `en.wikipedia`. |
| year | path | string | yes | `YYYY`. |
| month | path | string | yes | `MM`. |
| day | path | string | yes | `DD`. |

Returns: `items[0].articles[]` with `article`, `views`, `rank`.

### Caveats

- Data is available from July 2015, about a day behind.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by wikimedia.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /article — Article views
- Gateway: `GET https://api.apiclay.com/v1/api/wikipediapageviewsapi/article`
- Public query params: `project` (string, required), `article` (string, required), `granularity` (string, required), `start` (string, required), `end` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /top — Top articles
- Gateway: `GET https://api.apiclay.com/v1/api/wikipediapageviewsapi/top`
- Public query params: `project` (string, required), `year` (string, required), `month` (string, required), `day` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/wikipediapageviewsapi/article?project=<project>&article=<article>&granularity=<granularity>&start=<start>&end=<end>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
