Wikimedia Pageviews Scraper

Get Wikipedia and Wikimedia pageview statistics straight from the official Wikimedia REST API — no account, no API key, no cookies. Track how much attention any article receives over time, discover the most-viewed articles for any day or month, and measure the total traffic of an entire Wikipedia edition.

Perfect for trend research, SEO and content strategy, market and interest analysis, journalism, and academic studies into what the world is reading.

What it does

This actor fetches structured pageview metrics across 40+ Wikimedia projects (Wikipedia in every major language, plus Wikimedia Commons, Wikidata, Wiktionary, Wikisource, Wikivoyage and more). It supports four complementary modes:

Mode	What you get
Per-article pageviews	Daily or monthly view counts for one or more articles over a date range
Top / most-viewed articles	The ranked list of the most-viewed articles for a specific day or a whole month
Aggregate project pageviews	Total pageviews for an entire project over a date range
Top articles by country	The ranked most-viewed articles in a specific country for a day, across all projects

Example use cases

• Measure whether interest in a topic is rising or falling over months and years
• Find the trending articles for the day a major event happened
• Compare desktop vs. mobile readership for a page
• Benchmark public interest across different language editions of the same topic
• Feed reader-demand signals into content-planning and SEO dashboards

Input

Configure the run from the Input tab or via JSON. Key fields:

Field	Description
mode	articlePageviews, topArticles, aggregatePageviews, or topArticlesByCountry
project	The wiki to query, e.g. en.wikipedia, fr.wikipedia, commons.wikimedia, www.wikidata
articles	Article titles or full wiki URLs (Per-article mode). Spaces are converted to underscores automatically
access	all-access, desktop, mobile-app, or mobile-web
agent	user (humans only), all-agents, spider, or automated
granularity	daily or monthly (Per-article & Aggregate modes)
startDate / endDate	Date range in YYYYMMDD (or YYYY-MM-DD) format. Data begins 2015-07-01
topYear / topMonth / topDay	The date to rank for (Top mode). Set day to all-days for a whole-month ranking
country	ISO 3166-1 alpha-2 country code (Top-by-country mode), e.g. US, GB, DE, IN
maxItems	Hard cap on the number of records returned

Example input

{
  "mode": "articlePageviews",
  "project": "en.wikipedia",
  "articles": ["Albert Einstein", "Python (programming language)"],
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "startDate": "20240101",
  "endDate": "20240301"
}

Output

Every record is a flat JSON object. Empty fields are omitted, so you never get null values.

Per-article / aggregate record

{
  "recordType": "pageviews",
  "project": "en.wikipedia",
  "article": "Albert_Einstein",
  "articleLabel": "Albert Einstein",
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "date": "2024-01-01",
  "views": 639747,
  "articleUrl": "https://en.wikipedia.org/wiki/Albert_Einstein",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/...",
  "scrapedAt": "2026-07-02T13:25:30.111789+00:00"
}

Top-articles record

{
  "recordType": "topArticle",
  "project": "en.wikipedia",
  "access": "all-access",
  "date": "2024-01",
  "article": "Main_Page",
  "articleLabel": "Main Page",
  "views": 152225418,
  "rank": 1,
  "articleUrl": "https://en.wikipedia.org/wiki/Main_Page",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/top/...",
  "scrapedAt": "2026-07-02T13:25:37.454208+00:00"
}

Top-by-country record

{
  "recordType": "topArticleByCountry",
  "country": "US",
  "access": "all-access",
  "date": "2024-01-01",
  "project": "en.wikipedia",
  "article": "Main_Page",
  "articleLabel": "Main Page",
  "viewsCeil": 1866400,
  "rank": 1,
  "articleUrl": "https://en.wikipedia.org/wiki/Main_Page",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/top-per-country/...",
  "scrapedAt": "2026-07-02T13:25:41.001200+00:00"
}

Output fields

Field	Present in	Description
recordType	all	pageviews, topArticle, aggregate, or topArticleByCountry
country	top-by-country	ISO 3166-1 alpha-2 country code the ranking covers
project	all	The Wikimedia project queried (per-entry in top-by-country, as rankings span projects)
article	per-article, top, top-by-country	Article token (underscored)
articleLabel	per-article, top, top-by-country	Human-readable article title (spaces)
access	all	Access method the counts cover
agent	per-article, aggregate	Traffic source
granularity	per-article, aggregate	daily or monthly
date	all	The period the count belongs to
views	per-article, top, aggregate	Number of pageviews
viewsCeil	top-by-country	Privacy-bucketed (ceiling-rounded) view count published for country rankings
rank	top, top-by-country	Position in the most-viewed ranking
articleUrl	per-article, top, top-by-country	Direct link to the article
sourceUrl	all	The API endpoint the record came from
scrapedAt	all	UTC timestamp of the run

Data source

Data comes from the public Wikimedia REST API pageviews endpoints, which the Wikimedia Foundation publishes openly. The actor sends a descriptive User-Agent as requested by Wikimedia's API policy. Pageview data is available from July 2015 onward and is typically updated through the previous day.

FAQ

Do I need an API key or account? No. The Wikimedia pageviews API is completely public and free.

How far back does the data go? Daily and monthly pageview data is available from 2015-07-01 onward.

Which projects are supported? 40+ projects, including Wikipedia in all major languages plus Wikimedia Commons, Wikidata, Meta-Wiki, Wiktionary, Wikisource, Wikiquote, Wikivoyage, Wikibooks and Wikinews. Choose one from the project dropdown.

Why do human-only counts differ from all-agents? The user agent filter excludes known bots and crawlers, giving a cleaner picture of genuine human readership. Use all-agents to include everything.

Can I get the top articles for an entire month? Yes — in Top mode, set topDay to all-days to receive the whole-month ranking.

Can I see the most-viewed articles in a specific country? Yes — use topArticlesByCountry mode with a country code (e.g. US, DE, IN). It returns the daily ranking across all Wikimedia projects. Because Wikimedia publishes country-level data with privacy protection, this mode reports viewsCeil (a ceiling-rounded view count) instead of an exact views figure, and is available per day rather than per whole month.

What happens if an article has no data? Articles with no recorded views for the chosen range are simply skipped; the run still completes successfully.