# Wikipedia Pageviews API
> Wikipedia pageview statistics as an API, live from the official Wikimedia REST API. See the most-viewed Wikipedia articles for any day — a real-time pulse of what the world is reading and searching for — with junk namespaces filtered out by default, and get the daily (or monthly) view counts and totals for any individual article over any date range. Works for any language edition (en.wikipedia, de.wikipedia, fr.wikipedia and 300+ projects) and any access method (desktop, mobile-web, mobile-app). Ideal for trend analysis, news, research, dashboards, SEO and content strategy. Public Wikimedia data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/pageviews-api/..."
```

## Pricing
- **Free** (Free) — 3,500 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 49,000 calls/Mo, 8 req/s
- **Pro** ($12/Mo) — 241,000 calls/Mo, 20 req/s
- **Mega** ($33/Mo) — 1,200,000 calls/Mo, 50 req/s

## Endpoints

### Pageviews

#### `GET /v1/article` — Daily views for one article

**Parameters:**
- `title` (query, required, string) — Article title, e.g. Chess Example: `Chess`
- `project` (query, optional, string) — Wikimedia project (default en.wikipedia)
- `days` (query, optional, string) — Last N days (default 30) Example: `30`
- `from` (query, optional, string) — Start date YYYY-MM-DD
- `to` (query, optional, string) — End date YYYY-MM-DD
- `granularity` (query, optional, string) — daily | monthly

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pageviews-api/v1/article?title=Chess&days=30"
```

**Response:**
```json
{
    "data": {
        "count": 31,
        "title": "Chess",
        "access": "all-access",
        "series": [
            {
                "date": "2026-04-29",
                "views": 4446
            },
            {
                "date": "2026-04-30",
                "views": 4027
            },
            {
                "date": "2026-05-01",
                "views": 4211
            },
            {
                "date": "2026-05-02",
                "views": 3368
            },
            {
                "date": "2026-05-03",
                "views": 3342
            },
            {
                "date": "2026-05-04",
                "views": 3694
            },
            {
                "date": "2026-05-05",
                "views": 3871
            },
            {
                "date": "2026-05-06",
                "views": 3985
            },
            {
                "date": "2026-05-07",
                "views": 3877
            },
            {
                "date": "2026-05-08",
                "views": 4036
            },
            {
                "date": "2026-05-09",
                "views": 3302
            },
            {
                "date": "2026-05-10",
                "views": 3474
            },
            {
                "date": "2026-05-11",
                "views": 4320
            },
            {
                "date": "2026-05-12",
                "views": 4307
            },
            {
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/top` — Most-viewed articles for a day

**Parameters:**
- `project` (query, optional, string) — Wikimedia project, e.g. en.wikipedia, de.wikipedia Example: `en.wikipedia`
- `date` (query, optional, string) — Day YYYY-MM-DD (default: latest available)
- `access` (query, optional, string) — all-access | desktop | mobile-web | mobile-app
- `clean` (query, optional, string) — false = include Main_Page / Special: namespaces
- `limit` (query, optional, string) — Max articles (1-1000, default 25) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pageviews-api/v1/top?project=en.wikipedia&limit=25"
```

**Response:**
```json
{
    "data": {
        "date": "2026-05-29",
        "count": 25,
        "access": "all-access",
        "cleaned": true,
        "project": "en.wikipedia",
        "results": [
            {
                "rank": 1,
                "title": "Backrooms (film)",
                "views": 414298,
                "article": "Backrooms_(film)"
            },
            {
                "rank": 2,
                "title": "Claude Lemieux",
                "views": 347318,
                "article": "Claude_Lemieux"
            },
            {
                "rank": 3,
                "title": ".xxx",
                "views": 269906,
                "article": ".xxx"
            },
            {
                "rank": 4,
                "title": "Obsession (2025 film)",
                "views": 233530,
                "article": "Obsession_(2025_film)"
            },
            {
                "rank": 5,
                "title": "Spider-Noir",
                "views": 167553,
                "article": "Spider-Noir"
            },
            {
                "rank": 6,
                "title": "Vaibhav Sooryavanshi",
                "views": 150522,
                "article": "Vaibhav_Sooryavanshi"
            },
            {
                "rank": 7,
                "title": "Deaths in 2026",
                "views": 132092,
                "article": "Deaths_in_2026"
            },
            {
                "rank": 8,
                "title": ".xyz",
          
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & options

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pageviews-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live Wikipedia pageview statistics. /v1/top = the most-viewed articles for a day (default: the latest available day, ~2-day lag; junk namespaces filtered unless clean=false). /v1/article = daily/monthly view counts for one article over a date range. project defaults to en.wikipedia; supports any Wikimedia project (de.wikipedia, fr.wikipedia, …).",
        "source": "Wikimedia REST API (pageviews)",
        "endpoints": [
            "/v1/top",
            "/v1/article",
            "/v1/meta"
        ],
        "access_options": [
            "all-access",
            "desktop",
            "mobile-web",
            "mobile-app"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T09:42:05.203Z",
        "request_id": "18a66ea9-0c01-494d-a0ff-31fa64c33e68"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/pageviews-api
OpenAPI spec: https://www.oanor.com/api/pageviews-api/openapi.json