# Wikimedia Analytics

> Statistics for Wikipedia and the other Wikimedia projects: page views of a page or a whole project, the most-viewed pages by project or country, unique devices, edits, editors, new users and pages, bytes changed, and downloads of media files. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/wikimedia-analytics

## Actions

### Get bytes changed

Measure how much text edits added to a project, in bytes, by day or month: the net change (added minus removed) or the absolute change (added plus removed). A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Change (`change`, text): Net: bytes added minus bytes removed. Absolute: every byte added or removed. Defaults to net. One of: `net` (Net (bytes added minus bytes removed)), `absolute` (Absolute (bytes added plus bytes removed)). Default: `net`.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count edits to articles, to other pages, or to all pages. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `all-page-types`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `change` (text): 'net' (added minus removed) or 'absolute' (added plus removed).
- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_bytes` (number): Bytes changed over the whole range.

**Example output**

```json
{
  "change": "net",
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "bytes": 354012441,
      "date": "2026-08-01",
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "bytes": 315211719,
      "date": "2026-09-01",
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01",
  "total_bytes": 669224160
}
```

### Get bytes changed on a page

Measure how much text edits added to one page, in bytes, by day or month: the net change (added minus removed) or the absolute change (added plus removed). A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Page title (`title`, text, required): The page's title as it appears on the wiki, such as Albert Einstein, or a link to the page.
- Change (`change`, text): Net: bytes added minus bytes removed. Absolute: every byte added or removed. Defaults to net. One of: `net` (Net (bytes added minus bytes removed)), `absolute` (Absolute (bytes added plus bytes removed)). Default: `net`.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `change` (text): 'net' (added minus removed) or 'absolute' (added plus removed).
- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `title` (text): The page's title, with spaces, e.g. 'Albert Einstein'.
- `total_bytes` (number): Bytes changed over the whole range.
- `url` (text): A link to the page.

**Example output**

```json
{
  "change": "net",
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "bytes": 489,
      "date": "2026-08-01",
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "bytes": 783,
      "date": "2026-09-01",
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01",
  "title": "Albert Einstein",
  "total_bytes": 1272,
  "url": "https://en.wikipedia.org/wiki/Albert_Einstein"
}
```

### Get editors by country

See roughly how many of a project's editors were in each country in a month, rounded up to protect their privacy. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Edits per editor (`activity_level`, text): Only count editors who made this many edits in the month. One of: `5..99-edits` (5 to 99 edits), `100..-edits` (100 edits or more). Default: `5..99-edits`.
- Month (`month`, date): Any day in the month to look at. Leave empty for last month.

**Outputs**

- `activity_level` (text): The edits per editor counted, e.g. '5..99-edits'.
- `count` (number): How many entries came back.
- `countries` (list): The countries, most editors first.
- `month` (text): The month (YYYY-MM).
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.

**Example output**

```json
{
  "activity_level": "5..99-edits",
  "count": 2,
  "countries": [
    {
      "country": "US",
      "country_name": "United States",
      "editors": 18510
    },
    {
      "country": "GB",
      "country_name": "Britain (UK)",
      "editors": 4890
    }
  ],
  "month": "2026-09",
  "project": "en.wikipedia"
}
```

### Get edits to a page

Count the edits made to one page, by day or month, with the total. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Page title (`title`, text, required): The page's title as it appears on the wiki, such as Albert Einstein, or a link to the page.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `title` (text): The page's title, with spaces, e.g. 'Albert Einstein'.
- `total_edits` (number): Edits over the whole range.
- `url` (text): A link to the page.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-08-01",
      "edits": 17,
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "date": "2026-09-01",
      "edits": 9,
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01",
  "title": "Albert Einstein",
  "total_edits": 26,
  "url": "https://en.wikipedia.org/wiki/Albert_Einstein"
}
```

### Get media requests

Count how many times images, videos, audio and other media files were downloaded from Wikimedia's servers, by day or month, and from where. A day's figures are ready the next day.

**Inputs**

- Requested from (`referer`, text): Where the requests came from: anywhere, search engines, other websites, or a project such as en.wikipedia. Defaults to anywhere.
- Media (`media_type`, text): Only count this kind of file. Defaults to all media. One of: `all-media-types` (All media), `image` (Images), `video`, `audio`, `document` (Documents (PDF and similar)), `other` (Other files). Default: `all-media-types`.
- Requested by (`agent`, text): Count requests by people, by crawlers, or by everyone. One of: `user` (People), `all-agents` (Everyone (people and crawlers)), `spider` (Crawlers that say they are bots). Default: `user`.
- Per (`granularity`, text): One figure per day or per month. One of: `daily`, `monthly`. Default: `daily`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `media_type` (text): all-media-types, image, video, audio, document or other.
- `referer` (text): Where the requests came from: all-referers, internal, external, search-engine, unknown, none, or a project such as en.wikipedia.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_requests` (number): Requests over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-10-02",
  "granularity": "daily",
  "media_type": "image",
  "referer": "all-referers",
  "series": [
    {
      "date": "2026-10-01",
      "requests": 2231966837,
      "timestamp": "2026-10-01T00:00:00Z"
    },
    {
      "date": "2026-10-02",
      "requests": 2316429645,
      "timestamp": "2026-10-02T00:00:00Z"
    }
  ],
  "start_date": "2026-10-01",
  "total_requests": 4548396482
}
```

### Get media requests for a file

Count how many times one media file, such as an image on Wikimedia Commons, was downloaded, by day or month, with the total. A day's figures are ready the next day.

**Inputs**

- File (`file`, text, required): A file on Wikimedia Commons, by name (Albert Einstein Head.jpg) or by link, or any upload.wikimedia.org link.
- Requested from (`referer`, text): Where the requests came from: anywhere, search engines, other websites, or a project such as en.wikipedia. Defaults to anywhere.
- Requested by (`agent`, text): Count requests by people, by crawlers, or by everyone. One of: `user` (People), `all-agents` (Everyone (people and crawlers)), `spider` (Crawlers that say they are bots). Default: `user`.
- Per (`granularity`, text): One figure per day or per month. One of: `daily`, `monthly`. Default: `daily`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `file_name` (text): The file's name, with spaces.
- `file_path` (text): The file's path on upload.wikimedia.org.
- `file_url` (text): A link to the file.
- `granularity` (text): hourly, daily or monthly.
- `referer` (text): Where the requests came from: all-referers, internal, external, search-engine, unknown, none, or a project such as en.wikipedia.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_requests` (number): Downloads over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-10-02",
  "file_name": "Albert Einstein Head.jpg",
  "file_path": "/wikipedia/commons/d/d3/Albert_Einstein_Head.jpg",
  "file_url": "https://upload.wikimedia.org/wikipedia/commons/d/d3/Albert_Einstein_Head.jpg",
  "granularity": "daily",
  "referer": "all-referers",
  "series": [
    {
      "date": "2026-10-01",
      "requests": 14707,
      "timestamp": "2026-10-01T00:00:00Z"
    },
    {
      "date": "2026-10-02",
      "requests": 11247,
      "timestamp": "2026-10-02T00:00:00Z"
    }
  ],
  "start_date": "2026-10-01",
  "total_requests": 25954
}
```

### Get new registered users

Count the accounts registered on a project (or on every project) each day or month, with the total. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_new_users` (number): Accounts registered over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-02",
  "granularity": "daily",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-09-01",
      "new_users": 3809,
      "timestamp": "2026-09-01T00:00:00Z"
    },
    {
      "date": "2026-09-02",
      "new_users": 3763,
      "timestamp": "2026-09-02T00:00:00Z"
    }
  ],
  "start_date": "2026-09-01",
  "total_new_users": 7572
}
```

### Get number of edited pages

Count how many different pages were edited on a project each day or month. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count edits to articles, to other pages, or to all pages. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `all-page-types`.
- Edits per editor (`activity_level`, text): Only count editors (or pages) with this many edits in the period. Defaults to any number. One of: `all-activity-levels` (Any number of edits), `1..4-edits` (1 to 4 edits), `5..24-edits` (5 to 24 edits), `25..99-edits` (25 to 99 edits), `100..-edits` (100 edits or more). Default: `all-activity-levels`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-08-01",
      "edited_pages": 1081857,
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "date": "2026-09-01",
      "edited_pages": 938115,
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01"
}
```

### Get number of editors

Count how many people (or bots) edited a project each day or month, optionally only those who made a given number of edits. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count edits to articles, to other pages, or to all pages. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `all-page-types`.
- Edits per editor (`activity_level`, text): Only count editors (or pages) with this many edits in the period. Defaults to any number. One of: `all-activity-levels` (Any number of edits), `1..4-edits` (1 to 4 edits), `5..24-edits` (5 to 24 edits), `25..99-edits` (25 to 99 edits), `100..-edits` (100 edits or more). Default: `all-activity-levels`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-08-01",
      "editors": 18571,
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "date": "2026-09-01",
      "editors": 18385,
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01"
}
```

### Get number of edits

Count the edits made to a project, to a whole family such as every Wikipedia, or to every project, by day or month, with the total. Filter by kind of editor and page. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count edits to articles, to other pages, or to all pages. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `all-page-types`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_edits` (number): Edits over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-02",
  "granularity": "daily",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-09-01",
      "edits": 233627,
      "timestamp": "2026-09-01T00:00:00Z"
    },
    {
      "date": "2026-09-02",
      "edits": 193987,
      "timestamp": "2026-09-02T00:00:00Z"
    }
  ],
  "start_date": "2026-09-01",
  "total_edits": 427614
}
```

### Get number of new pages

Count the pages created on a project each day or month, with the total. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count articles, other pages, or all pages. Defaults to articles. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `content`.
- Per (`granularity`, text): One figure per day or per month. Defaults to monthly. One of: `daily`, `monthly`. Default: `monthly`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_new_pages` (number): Pages created over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-09-30",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-08-01",
      "new_pages": 17695,
      "timestamp": "2026-08-01T00:00:00Z"
    },
    {
      "date": "2026-09-01",
      "new_pages": 16461,
      "timestamp": "2026-09-01T00:00:00Z"
    }
  ],
  "start_date": "2026-08-01",
  "total_new_pages": 34156
}
```

### Get page views by country

See which countries a project's readers were in during a month, ranked, with their views given as ranges to protect readers' privacy.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, or all-projects for every Wikimedia project together.
- Month (`month`, date): Any day in the month to look at. Leave empty for last month.
- Read on (`access`, text): Count views on the desktop site, the mobile site, the apps, or all. One of: `all-access` (All (desktop, mobile site and apps)), `desktop` (Desktop site), `mobile-web` (Mobile site), `mobile-app` (Wikipedia apps). Default: `all-access`.

**Outputs**

- `count` (number): How many entries came back.
- `countries` (list): The countries, most views first. Countries with 100 views or fewer are left out.
- `month` (text): The month (YYYY-MM).
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.

**Example output**

```json
{
  "count": 2,
  "countries": [
    {
      "country": "US",
      "country_name": "United States",
      "rank": 1,
      "views": 2663042000,
      "views_range": "1000000000-9999999999"
    },
    {
      "country": "GB",
      "country_name": "Britain (UK)",
      "rank": 2,
      "views": 692606000,
      "views_range": "100000000-999999999"
    }
  ],
  "month": "2026-09",
  "project": "en.wikipedia"
}
```

### Get page views of a page

Count how many times a page on Wikipedia or another Wikimedia project was viewed, day by day or month by month, with the total. Filter by desktop, mobile site or apps, and by people or bots. A day's figures are ready the next day.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Page title (`title`, text, required): The page's title as it appears on the wiki, such as Albert Einstein, or a link to the page.
- Read on (`access`, text): Count views on the desktop site, the mobile site, the apps, or all. One of: `all-access` (All (desktop, mobile site and apps)), `desktop` (Desktop site), `mobile-web` (Mobile site), `mobile-app` (Wikipedia apps). Default: `all-access`.
- Readers (`agent`, text): Count views by people, by crawlers and bots, or by everyone. Defaults to people. One of: `user` (People), `all-agents` (Everyone (people, crawlers and bots)), `spider` (Crawlers that say they are bots), `automated` (Automated traffic Wikimedia detected). Default: `user`.
- Per (`granularity`, text): One figure per day or per month. One of: `daily`, `monthly`. Default: `daily`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `title` (text): The page's title, with spaces, e.g. 'Albert Einstein'.
- `total_views` (number): Page views over the whole range.
- `url` (text): A link to the page.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-10-16",
  "granularity": "daily",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-10-15",
      "timestamp": "2026-10-15T00:00:00Z",
      "views": 9933
    },
    {
      "date": "2026-10-16",
      "timestamp": "2026-10-16T00:00:00Z",
      "views": 10076
    }
  ],
  "start_date": "2026-10-15",
  "title": "Albert Einstein",
  "total_views": 20009,
  "url": "https://en.wikipedia.org/wiki/Albert_Einstein"
}
```

### Get page views of a project

Count page views of a whole project, such as English Wikipedia, or of every Wikimedia project together, by hour, day or month, with the total. A day's figures are ready the next day.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, or all-projects for every Wikimedia project together.
- Read on (`access`, text): Count views on the desktop site, the mobile site, the apps, or all. One of: `all-access` (All (desktop, mobile site and apps)), `desktop` (Desktop site), `mobile-web` (Mobile site), `mobile-app` (Wikipedia apps). Default: `all-access`.
- Readers (`agent`, text): Count views by people, by crawlers and bots, or by everyone. Defaults to people. One of: `user` (People), `all-agents` (Everyone (people, crawlers and bots)), `spider` (Crawlers that say they are bots), `automated` (Automated traffic Wikimedia detected). Default: `user`.
- Per (`granularity`, text): One figure per hour (in UTC), per day or per month. One of: `hourly`, `daily`, `monthly`. Default: `daily`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.
- `total_views` (number): Page views over the whole range.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-03-31",
  "granularity": "monthly",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-02-01",
      "timestamp": "2026-02-01T00:00:00Z",
      "views": 6352436517
    },
    {
      "date": "2026-03-01",
      "timestamp": "2026-03-01T00:00:00Z",
      "views": 6794115655
    }
  ],
  "start_date": "2026-02-01",
  "total_views": 13146552172
}
```

### Get unique devices

Estimate how many different devices visited a project each day or month: Wikimedia's privacy-friendly count of readers, which doesn't need accounts or tracking.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, or a whole family such as all-wikipedia-projects. Devices aren't counted across all projects.
- Site (`site`, text): Count devices on the desktop site, the mobile site, or both. One of: `all-sites` (All sites), `desktop-site` (Desktop site), `mobile-site` (Mobile site). Default: `all-sites`.
- Per (`granularity`, text): One figure per day or per month. One of: `daily`, `monthly`. Default: `daily`.
- From (`start_date`, date): The first day to include. Leave empty for 30 days (or 12 months, when monthly) before the end.
- To (`end_date`, date): The last day to include. Leave empty for yesterday, the last day with figures.

**Outputs**

- `count` (number): How many periods came back.
- `end_date` (text): The last day covered (YYYY-MM-DD).
- `granularity` (text): hourly, daily or monthly.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `series` (list): One entry per hour, day or month, oldest first. Wikimedia leaves out periods with nothing counted.
- `start_date` (text): The first day covered (YYYY-MM-DD); for monthly figures, the first of the month.

**Example output**

```json
{
  "count": 2,
  "end_date": "2026-10-02",
  "granularity": "daily",
  "project": "en.wikipedia",
  "series": [
    {
      "date": "2026-10-01",
      "devices": 58156977,
      "offset": 16313609,
      "timestamp": "2026-10-01T00:00:00Z",
      "underestimate": 41843368
    },
    {
      "date": "2026-10-02",
      "devices": 57194926,
      "offset": 16189180,
      "timestamp": "2026-10-02T00:00:00Z",
      "underestimate": 41005746
    }
  ],
  "start_date": "2026-10-01"
}
```

### List most-active editors

List up to 100 editors with the most edits, or the most bytes added or changed, on a project over a month or on one day. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Rank by (`rank_by`, text): Rank by number of edits, by bytes added minus removed, or by all bytes added and removed. One of: `edits` (Number of edits), `net-bytes` (Net change in bytes (added minus removed)), `absolute-bytes` (Absolute change in bytes (added plus removed)). Default: `edits`.
- Editors (`editor_type`, text): Only rank this kind of editor. Defaults to registered users, since bots would fill the list. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `user`.
- Pages (`page_type`, text): Only count articles, other pages, or all pages. Defaults to articles. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `content`.
- Day (`day`, date): Any day in the month to list (or the day itself, for one day). Leave empty for last month. A month's figures arrive a few days after it ends.
- Period (`period`, text): The whole month the day falls in, or that day alone. One of: `day` (That day), `month` (That whole month). Default: `month`.
- Number of results (`limit`, number): How many to list, from the top, 1 to 100. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many entries came back.
- `date` (text): The day (YYYY-MM-DD), or the month (YYYY-MM) for a whole month.
- `editors` (list): The editors, highest first.
- `period` (text): 'day' for one day's figures, 'month' for a whole month's.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `ranked_by` (text): What the list is ranked by: 'edits', 'net-bytes' or 'absolute-bytes'.

**Example output**

```json
{
  "count": 2,
  "date": "2026-09",
  "editors": [
    {
      "absolute_bytes": null,
      "edits": 60733,
      "net_bytes": null,
      "rank": 1,
      "user": "Staryu"
    },
    {
      "absolute_bytes": null,
      "edits": 33003,
      "net_bytes": null,
      "rank": 2,
      "user": "Zackmann08"
    }
  ],
  "period": "month",
  "project": "en.wikipedia",
  "ranked_by": "edits"
}
```

### List most-edited pages

List up to 100 pages with the most edits, or the most bytes added or changed, on a project over a month or on one day. A month's figures arrive a few days after it ends.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia, a whole family such as all-wikipedia-projects, or all-projects for every Wikimedia project.
- Rank by (`rank_by`, text): Rank by number of edits, by bytes added minus removed, or by all bytes added and removed. One of: `edits` (Number of edits), `net-bytes` (Net change in bytes (added minus removed)), `absolute-bytes` (Absolute change in bytes (added plus removed)). Default: `edits`.
- Editors (`editor_type`, text): Only count edits by this kind of editor. Defaults to everyone. One of: `all-editor-types` (Everyone), `user` (Registered users), `anonymous` (Unregistered (IP addresses and temporary accounts)), `group-bot` (Bot accounts), `name-bot` (Accounts with bot-like names). Default: `all-editor-types`.
- Pages (`page_type`, text): Only count articles, other pages, or all pages. Defaults to articles. One of: `all-page-types` (All pages), `content` (Content pages (articles)), `non-content` (Other pages (talk, user, project and so on)). Default: `content`.
- Day (`day`, date): Any day in the month to list (or the day itself, for one day). Leave empty for last month. A month's figures arrive a few days after it ends.
- Period (`period`, text): The whole month the day falls in, or that day alone. One of: `day` (That day), `month` (That whole month). Default: `month`.
- Number of results (`limit`, number): How many to list, from the top, 1 to 100. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many entries came back.
- `date` (text): The day (YYYY-MM-DD), or the month (YYYY-MM) for a whole month.
- `pages` (list): The pages, highest first.
- `period` (text): 'day' for one day's figures, 'month' for a whole month's.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.
- `ranked_by` (text): What the list is ranked by: 'edits', 'net-bytes' or 'absolute-bytes'.

**Example output**

```json
{
  "count": 2,
  "date": "2026-09",
  "pages": [
    {
      "absolute_bytes": null,
      "edits": 2163,
      "net_bytes": null,
      "rank": 1,
      "title": "Deaths in 2026",
      "url": "https://en.wikipedia.org/wiki/Deaths_in_2026"
    },
    {
      "absolute_bytes": null,
      "edits": 1360,
      "net_bytes": null,
      "rank": 2,
      "title": "India at the 2026 Asian Games",
      "url": "https://en.wikipedia.org/wiki/India_at_the_2026_Asian_Games"
    }
  ],
  "period": "month",
  "project": "en.wikipedia",
  "ranked_by": "edits"
}
```

### List most-requested files

List the media files downloaded most on a day or over a whole month, up to 1,000 of them. A day's figures are ready the next day.

**Inputs**

- Requested from (`referer`, text): Where the requests came from: anywhere, search engines, other websites, or a project such as en.wikipedia. Defaults to anywhere.
- Media (`media_type`, text): Only count this kind of file. Defaults to all media. One of: `all-media-types` (All media), `image` (Images), `video`, `audio`, `document` (Documents (PDF and similar)), `other` (Other files). Default: `all-media-types`.
- Day (`day`, date): The day to list (or any day in the month, for a whole month). Leave empty for yesterday.
- Period (`period`, text): That day alone, or the whole month it falls in. One of: `day` (That day), `month` (That whole month). Default: `day`.
- Number of results (`limit`, number): How many to list, from the top, 1 to 1,000. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many entries came back.
- `date` (text): The day (YYYY-MM-DD), or the month (YYYY-MM) for a whole month.
- `files` (list): The files, most requested first.
- `media_type` (text): all-media-types, image, video, audio, document or other.
- `period` (text): 'day' for one day's figures, 'month' for a whole month's.
- `referer` (text): Where the requests came from: all-referers, internal, external, search-engine, unknown, none, or a project such as en.wikipedia.

**Example output**

```json
{
  "count": 2,
  "date": "2026-10-18",
  "files": [
    {
      "file_name": "Icon pdf file.png",
      "file_path": "/wikipedia/commons/4/4d/Icon_pdf_file.png",
      "rank": 1,
      "requests": 16392266,
      "url": "https://upload.wikimedia.org/wikipedia/commons/4/4d/Icon_pdf_file.png"
    },
    {
      "file_name": "Lock-red-alt-2.svg",
      "file_path": "/wikipedia/commons/a/aa/Lock-red-alt-2.svg",
      "rank": 2,
      "requests": 12334554,
      "url": "https://upload.wikimedia.org/wikipedia/commons/a/aa/Lock-red-alt-2.svg"
    }
  ],
  "media_type": "image",
  "period": "day",
  "referer": "en.wikipedia"
}
```

### List most-viewed pages

List a project's most-viewed pages on a day or over a whole month, with their views, up to 1,000 of them. A day's figures are ready the next day.

**Inputs**

- Project (`project`, text, required): The wiki, such as en.wikipedia (English Wikipedia), de.wiktionary or commons.wikimedia. Pick one, or type its address.
- Day (`day`, date): The day to list (or any day in the month, for a whole month). Leave empty for yesterday.
- Period (`period`, text): That day alone, or the whole month it falls in. One of: `day` (That day), `month` (That whole month). Default: `day`.
- Read on (`access`, text): Count views on the desktop site, the mobile site, the apps, or all. One of: `all-access` (All (desktop, mobile site and apps)), `desktop` (Desktop site), `mobile-web` (Mobile site), `mobile-app` (Wikipedia apps). Default: `all-access`.
- Number of results (`limit`, number): How many to list, from the top, 1 to 1,000. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many entries came back.
- `date` (text): The day (YYYY-MM-DD), or the month (YYYY-MM) for a whole month.
- `pages` (list): The pages, most viewed first.
- `period` (text): 'day' for one day's figures, 'month' for a whole month's.
- `project` (text): The project, as the API names it: en.wikipedia, commons.wikimedia, or all-projects for every project together.

**Example output**

```json
{
  "count": 2,
  "date": "2026-10-18",
  "pages": [
    {
      "rank": 1,
      "title": "Main Page",
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "views": 6401058
    },
    {
      "rank": 2,
      "title": "Special:Search",
      "url": "https://en.wikipedia.org/wiki/Special:Search",
      "views": 872891
    }
  ],
  "period": "day",
  "project": "en.wikipedia"
}
```

### List most-viewed pages in a country

List the pages people in one country read most on a day, across every Wikimedia project, with their views rounded up for privacy. Bots are left out.

**Inputs**

- Country (`country`, text, required): The country, or its two-letter code such as FR.
- Day (`day`, date): The day to list. Leave empty for yesterday.
- Read on (`access`, text): Count views on the desktop site, the mobile site, the apps, or all. One of: `all-access` (All (desktop, mobile site and apps)), `desktop` (Desktop site), `mobile-web` (Mobile site), `mobile-app` (Wikipedia apps). Default: `all-access`.
- Number of results (`limit`, number): How many to list, from the top, 1 to 1,000. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many entries came back.
- `country` (text): The two-letter country code (ISO 3166), e.g. 'FR'.
- `country_name` (text): The country's name in English, e.g. 'France'.
- `date` (text): The day (YYYY-MM-DD).
- `pages` (list): The pages, most viewed first.

**Example output**

```json
{
  "count": 2,
  "country": "FR",
  "country_name": "France",
  "date": "2026-10-18",
  "pages": [
    {
      "project": "fr.wikipedia",
      "rank": 1,
      "title": "Wikip\u00e9dia:Accueil principal",
      "url": "https://fr.wikipedia.org/wiki/Wikip%C3%A9dia:Accueil_principal",
      "views": 221500
    },
    {
      "project": "fr.wikipedia",
      "rank": 2,
      "title": "Guillaume Gu\u00e9rin (homme politique)",
      "url": "https://fr.wikipedia.org/wiki/Guillaume_Gu%C3%A9rin_(homme_politique)",
      "views": 71500
    }
  ]
}
```
