{"openapi":"3.1.0","info":{"title":"Wikipedia Pageviews API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pageviews-api","description":"oanor gateway"}],"tags":[{"name":"Pageviews"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/article":{"get":{"operationId":"get_v1_article","tags":["Pageviews"],"summary":"Daily views for one article","description":"","parameters":[{"name":"title","in":"query","required":true,"description":"Article title, e.g. Chess","schema":{"type":"string"},"example":"Chess"},{"name":"project","in":"query","required":false,"description":"Wikimedia project (default en.wikipedia)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Last N days (default 30)","schema":{"type":"string"},"example":"30"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"}},{"name":"granularity","in":"query","required":false,"description":"daily | monthly","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"date":"2026-05-13","views":4174},{"date":"2026-05-14","views":3912},{"date":"2026-05-15","views":3814},{"date":"2026-05-16","views":3159},{"date":"2026-05-17","views":2997},{"date":"2026-05-18","views":3801},{"date":"2026-05-19","views":4069},{"date":"2026-05-20","views":4140},{"date":"2026-05-21","views":4888},{"date":"2026-05-22","views":3880},{"date":"2026-05-23","views":3272},{"date":"2026-05-24","views":3250},{"date":"2026-05-25","views":3938},{"date":"2026-05-26","views":4063},{"date":"2026-05-27","views":4046},{"date":"2026-05-28","views":3920},{"date":"2026-05-29","views":4006}],"article":"Chess","project":"en.wikipedia","granularity":"daily","total_views":119589},"meta":{"timestamp":"2026-05-31T09:42:05.023Z","request_id":"9d7da2f5-1c82-4350-8f9c-47fc51a269ba"},"status":"ok","message":"Article views retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/top":{"get":{"operationId":"get_v1_top","tags":["Pageviews"],"summary":"Most-viewed articles for a day","description":"","parameters":[{"name":"project","in":"query","required":false,"description":"Wikimedia project, e.g. en.wikipedia, de.wikipedia","schema":{"type":"string"},"example":"en.wikipedia"},{"name":"date","in":"query","required":false,"description":"Day YYYY-MM-DD (default: latest available)","schema":{"type":"string"}},{"name":"access","in":"query","required":false,"description":"all-access | desktop | mobile-web | mobile-app","schema":{"type":"string"}},{"name":"clean","in":"query","required":false,"description":"false = include Main_Page / Special: namespaces","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max articles (1-1000, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","views":126377,"article":".xyz"},{"rank":9,"title":"Victor Wembanyama","views":121451,"article":"Victor_Wembanyama"},{"rank":10,"title":"2026 FIFA World Cup","views":118660,"article":"2026_FIFA_World_Cup"},{"rank":11,"title":"ChatGPT","views":106595,"article":"ChatGPT"},{"rank":12,"title":"Anthony Gordon (footballer)","views":104797,"article":"Anthony_Gordon_(footballer)"},{"rank":13,"title":"João Fonseca (tennis)","views":97187,"article":"João_Fonseca_(tennis)"},{"rank":14,"title":"Hercules von Oberberg","views":95865,"article":"Hercules_von_Oberberg"},{"rank":15,"title":"Lars Mejern Larsson","views":90834,"article":"Lars_Mejern_Larsson"},{"rank":16,"title":"The Backrooms","views":90217,"article":"The_Backrooms"},{"rank":17,"title":"Protactinium","views":88586,"article":"Protactinium"},{"rank":18,"title":"Neatsville, Kentucky","views":86901,"article":"Neatsville,_Kentucky"},{"rank":19,"title":"Murder of Dominic Russo and Davion Flanagan","views":82325,"article":"Murder_of_Dominic_Russo_and_Davion_Flanagan"},{"rank":20,"title":"Blast (2026 film)","views":81329,"article":"Blast_(2026_film)"},{"rank":21,"title":"Spencer Pratt","views":77718,"article":"Spencer_Pratt"},{"rank":22,"title":"Michael Jackson","views":77471,"article":"Michael_Jackson"},{"rank":23,"title":"2026 French Open – Men's singles","views":75587,"article":"2026_French_Open_–_Men's_singles"},{"rank":24,"title":"Off Campus","views":73287,"article":"Off_Campus"},{"rank":25,"title":"Disclosure Day","views":72183,"article":"Disclosure_Day"}]},"meta":{"timestamp":"2026-05-31T09:42:05.116Z","request_id":"fe735373-d083-4d41-9bf7-7dda0ea0ac74"},"status":"ok","message":"Top articles retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":410,"monthly_call_quota":49000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1230,"monthly_call_quota":241000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3340,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pageviews-api"}