# Wikipedia API: Get page views

> Returns human-reader view counts for a Wikipedia article by day or month, with totals, daily averages and the peak period.

Unofficial. Not affiliated with or endorsed by Wikipedia.

- Page: https://fous.com/methods/wikipedia.org/get-page-views
- Method: `wikipedia.org/get_page_views`, version 1
- Website: wikipedia.org
- Returns: article title and link, date range, total views, average views per day, peak day or month, chronological views
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `topic` | string | yes | `"Taylor Swift"` | The Wikipedia article name, such as Taylor Swift. |
| `end_date` | string | no |  | Last date to count, inclusive, such as 2026-08-31. Defaults to yesterday. |
| `group_by` | string | no |  | Group views by day or month, such as month. Defaults to day. One of "day", "month". Default "day". |
| `language` | string | no |  | Wikipedia language name or code, such as French or fr. Defaults to English. Default "English". |
| `start_date` | string | no |  | First date to count, inclusive, such as 2026-08-01. Defaults to 29 days before the end date. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "topic": "Taylor Swift"
}
```

Its output:

```json
{
  "peak": {
    "date": "2026-09-28",
    "views": 49080
  },
  "views": [
    {
      "date": "2026-09-23",
      "views": 27097
    },
    {
      "date": "2026-09-24",
      "views": 19750
    },
    {
      "date": "2026-09-25",
      "views": 37056
    }
  ],
  "end_date": "2026-10-22",
  "start_date": "2026-09-23",
  "total_views": 517194,
  "article_link": "https://en.wikipedia.org/wiki/Taylor_Swift",
  "article_title": "Taylor Swift",
  "average_views_per_day": 17239.8
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"wikipedia.org/get_page_views","input":{"topic":"Taylor Swift"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- How many times was the Eiffel Tower Wikipedia article viewed by readers last month, broken down by day?
- Show monthly reader views for the article on the Great Barrier Reef from January to June 2025 in French Wikipedia.
- What was the peak day for views of the Marie Curie article over the past 30 days on Wikipedia?
- I need the average daily pageviews for the Bitcoin article between 2024-03-01 and 2024-03-31, plus the total.
- Give me the chronological monthly view counts for the Taylor Swift article on English Wikipedia for 2023 with the overall total.

## Input schema

```json
{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "The Wikipedia article name, such as Taylor Swift."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Last date to count, inclusive, such as 2026-08-31. Defaults to yesterday."
    },
    "group_by": {
      "enum": [
        "day",
        "month"
      ],
      "type": "string",
      "default": "day",
      "description": "Group views by day or month, such as month. Defaults to day."
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Wikipedia language name or code, such as French or fr. Defaults to English."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "First date to count, inclusive, such as 2026-08-01. Defaults to 29 days before the end date."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "article_title",
    "article_link",
    "start_date",
    "end_date",
    "total_views",
    "average_views_per_day",
    "peak",
    "views"
  ],
  "properties": {
    "peak": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "date",
        "views"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Day, or first day of month."
        },
        "views": {
          "type": "integer",
          "description": "Human-reader views."
        }
      },
      "description": "Highest-view day or month in the selected period, or null if no counts are available.",
      "additionalProperties": false
    },
    "views": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "views"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "views": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "description": "Chronological daily or monthly reader views; monthly dates are the first of each month."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Last day counted."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "First day counted."
    },
    "total_views": {
      "type": "integer",
      "description": "Human-reader views during the period."
    },
    "article_link": {
      "type": "string",
      "description": "Link to the article."
    },
    "article_title": {
      "type": "string",
      "description": "Wikipedia article title."
    },
    "average_views_per_day": {
      "type": "number",
      "description": "Total views divided by calendar days in the period."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Wikipedia API: Get article summary](https://fous.com/methods/wikipedia.org/get-article-summary.md): Returns the opening summary, short description, main image, article link and last edit time for a Wikipedia topic in the chosen language. For ambiguous names it uses the top matching article and lists up to five alternatives.
- [Wikipedia API: Get full article](https://fous.com/methods/wikipedia.org/get-full-article.md): Returns the full text of a Wikipedia article in ordered sections, with its last edit time, reference count and visible categories, in any language edition. Footnotes, tables and navigation material are excluded; a topic that is not an exact title uses the best search match.
- [Wikipedia API: Get key facts from an article](https://fous.com/methods/wikipedia.org/get-key-facts.md): Returns the labeled facts, in order, from the information box of a Wikipedia article in any language edition. Articles without an information box have no facts.
- [Wikipedia API: Search articles](https://fous.com/methods/wikipedia.org/search-articles.md): Searches a Wikipedia language edition by keywords and returns matching articles in relevance order, with descriptions, snippets, word counts, last edit dates and links.
- [Wikipedia API: Get Wikipedia On this day](https://fous.com/methods/wikipedia.org/get-on-this-day.md): Returns Wikipedia's On this day events, births, deaths and holidays for a month and day, in a chosen Wikipedia language; events, births and deaths come newest year first.
- [Britannica API: Get article](https://fous.com/methods/britannica.com/get-article.md): Finds the best-matching Britannica encyclopedia article for a topic and returns its introduction, quick facts, section headings, update date and main image.
- [Internet Archive API: List archived snapshots of a page](https://fous.com/methods/web.archive.org/list-snapshots.md): Lists Wayback Machine captures of a web page, oldest first, with HTTP status and whether the content changed since the previous capture.
- [Fandom API: Get a wiki article](https://fous.com/methods/fandom.com/get-wiki-article.md): Finds a topic on the main English Fandom wiki for a franchise (picked from Fandom's cross-wiki search, or given as a wiki or article link) and returns the article's opening paragraphs, infobox facts, section headings, main image and links.
- [All Wikipedia methods](https://fous.com/methods/wikipedia.org.md)
