{"openapi":"3.1.0","info":{"title":"Wikipedia Trends API","version":"1.0.0","description":"Live readership-trend data from the Wikimedia Pageviews API — the official measure of what the world is reading on Wikipedia and its sister projects. See the most-viewed articles on any Wikipedia language edition for a given day (the daily trending list); pull the daily or monthly pageview trend for any single article over a date range; read a whole project's total pageviews over a range as a barometer of overall traffic; or rank several articles head-to-head by total views for topic-engagement comparison. Special / namespace pages (Main Page, Search, Portal…) are filtered out by default so the trending list is real articles. Read live from Wikimedia, nothing stored — data lags about 1-2 days, so ranges default to ending two days back. This is the Wikipedia readership-trend and topic-engagement layer for any trends, research, newsroom or analytics app — distinct from Wikipedia content APIs: this is the pageview, trending and engagement signal of what people are actually reading and how it changes.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wikitrends-api","description":"oanor gateway"}],"tags":[{"name":"Top"},{"name":"Article"},{"name":"Aggregate"},{"name":"Compare"},{"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/top":{"get":{"operationId":"get_v1_top","tags":["Top"],"summary":"Most-viewed articles for a day — the trending list","description":"","parameters":[{"name":"project","in":"query","required":false,"description":"Wiki project or bare language code","schema":{"type":"string"},"example":"en.wikipedia"},{"name":"date","in":"query","required":false,"description":"Day YYYY-MM-DD (defaults 2 days back)","schema":{"type":"string"},"example":"2026-06-08"},{"name":"limit","in":"query","required":false,"description":"Max results (1-1000)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"top":[{"rank":4,"title":"Obsession (2025 film)","views":291972,"article":"Obsession_(2025_film)"},{"rank":5,"title":"2026 Peruvian general election","views":281754,"article":"2026_Peruvian_general_election"},{"rank":6,"title":"2026 FIFA World Cup","views":264644,"article":"2026_FIFA_World_Cup"},{"rank":7,"title":"Backrooms (film)","views":174832,"article":"Backrooms_(film)"},{"rank":8,"title":"Alexander Zverev","views":163973,"article":"Alexander_Zverev"},{"rank":9,"title":"Masters of the Universe (2026 film)","views":155937,"article":"Masters_of_the_Universe_(2026_film)"},{"rank":10,"title":"Christian Eriksen","views":139845,"article":"Christian_Eriksen"},{"rank":11,"title":"Deaths in 2026","views":132986,"article":"Deaths_in_2026"},{"rank":12,"title":"Peddi","views":128308,"article":"Peddi"},{"rank":13,"title":"79th Tony Awards","views":127279,"article":"79th_Tony_Awards"},{"rank":14,"title":"Killing of Rachel Nickell","views":117991,"article":"Killing_of_Rachel_Nickell"},{"rank":15,"title":"Spencer Pratt","views":116916,"article":"Spencer_Pratt"},{"rank":16,"title":"Scary Movie (2026 film)","views":114201,"article":"Scary_Movie_(2026_film)"},{"rank":17,"title":"Stacey King","views":110003,"article":"Stacey_King"},{"rank":18,"title":"Inde Navarrette","views":105410,"article":"Inde_Navarrette"},{"rank":19,"title":"ChatGPT","views":105017,"article":"ChatGPT"},{"rank":20,"title":"Ford Creek Patrol Cabin","views":104947,"article":"Ford_Creek_Patrol_Cabin"},{"rank":21,"title":"Nelly Korda","views":104138,"article":"Nelly_Korda"},{"rank":22,"title":"Nithya Raman","views":100163,"article":"Nithya_Raman"},{"rank":23,"title":"Michael Jackson","views":96378,"article":"Michael_Jackson"},{"rank":24,"title":"2026 Armenian parliamentary election","views":93251,"article":"2026_Armenian_parliamentary_election"},{"rank":25,"title":".xxx","views":90002,"article":".xxx"},{"rank":26,"title":"Jalen Brunson","views":87519,"article":"Jalen_Brunson"},{"rank":27,"title":"Béla Pap","views":86893,"article":"Béla_Pap"},{"rank":28,"title":"Robert Napper","views":86007,"article":"Robert_Napper"},{"rank":29,"title":"Manav Suthar","views":84425,"article":"Manav_Suthar"},{"rank":30,"title":"Teach You a Lesson","views":83358,"article":"Teach_You_a_Lesson"},{"rank":31,"title":"FIFA World Cup","views":82434,"article":"FIFA_World_Cup"},{"rank":32,"title":"Lewis Hamilton","views":78769,"article":"Lewis_Hamilton"},{"rank":33,"title":"2026 Gilgit Baltistan Assembly election","views":77056,"article":"2026_Gilgit_Baltistan_Assembly_election"},{"rank":34,"title":"Neatsville, Kentucky","views":76614,"article":"Neatsville,_Kentucky"},{"rank":35,"title":"Anthony Head","views":75595,"article":"Anthony_Head"},{"rank":36,"title":"Disclosure Day","views":73445,"article":"Disclosure_Day"},{"rank":37,"title":"David Sullivan (businessman)","views":72605,"article":"David_Sullivan_(businessman)"},{"rank":38,"title":"Michael (2026 film)","views":72601,"article":"Michael_(2026_film)"},{"rank":39,"title":"Pink (singer)","views":71023,"article":"Pink_(singer)"},{"rank":40,"title":"Kristen Welker","views":68775,"article":"Kristen_Welker"},{"rank":41,"title":"Divock Origi","views":67928,"article":"Divock_Origi"},{"rank":42,"title":"Off Campus","views":67429,"article":"Off_Campus"},{"rank":43,"title":"The Backrooms","views":65829,"article":"The_Backrooms"},{"rank":44,"title":"Brett Goldstein","views":65004,"article":"Brett_Goldstein"},{"rank":45,"title":"Murder of Henry Nowak","views":64020,"article":"Murder_of_Henry_Nowak"},{"rank":47,"title":"Kimi Antonelli","views":62780,"article":"Kimi_Antonelli"},{"rank":48,"title":"Shoshana Bean","views":62549,"article":"Shoshana_Bean"},{"rank":49,"title":"Aubrey Plaza","views":60611,"article":"Aubrey_Plaza"},{"rank":50,"title":"Keiko Fujimori","views":57708,"article":"Keiko_Fujimori"},{"rank":51,"title":"Kim Kardashian","views":57699,"article":"Kim_Kardashian"},{"rank":52,"title":"Widow's Bay","views":57028,"article":"Widow's_Bay"},{"rank":53,"title":"Schmigadoon! (musical)","views":53260,"article":"Schmigadoon!_(musical)"},{"rank":54,"title":"XXX","views":52577,"article":"XXX"}],"date":"2026-06-08","count":50,"access":"all-access","source":"Wikimedia Pageviews","project":"en.wikipedia","excluded_special":true},"meta":{"timestamp":"2026-06-10T13:59:41.825Z","request_id":"66ce6e99-f268-4d80-a32d-3b98e4a7dd8e"},"status":"ok","message":"Top articles retrieved successfully","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/article":{"get":{"operationId":"get_v1_article","tags":["Article"],"summary":"Daily/monthly pageview trend for one article","description":"","parameters":[{"name":"article","in":"query","required":true,"description":"Article title (underscores ok)","schema":{"type":"string"},"example":"Cristiano_Ronaldo"},{"name":"project","in":"query","required":false,"description":"Wiki project","schema":{"type":"string"},"example":"en.wikipedia"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","from":"2026-06-01","count":8,"title":"Cristiano Ronaldo","access":"all-access","series":[{"date":"2026-06-01","views":35837},{"date":"2026-06-02","views":38298},{"date":"2026-06-03","views":39473},{"date":"2026-06-04","views":39922},{"date":"2026-06-05","views":41528},{"date":"2026-06-06","views":49555},{"date":"2026-06-07","views":52183},{"date":"2026-06-08","views":48521}],"source":"Wikimedia Pageviews","article":"Cristiano_Ronaldo","project":"en.wikipedia","granularity":"daily","total_views":345317},"meta":{"timestamp":"2026-06-10T13:59:42.003Z","request_id":"90c541b2-ee02-4a12-a9f3-0610fdfc5bd0"},"status":"ok","message":"Article trend retrieved successfully","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/aggregate":{"get":{"operationId":"get_v1_aggregate","tags":["Aggregate"],"summary":"A project's total pageviews over a range","description":"","parameters":[{"name":"project","in":"query","required":false,"description":"Wiki project","schema":{"type":"string"},"example":"en.wikipedia"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"},{"name":"granularity","in":"query","required":false,"description":"daily or monthly","schema":{"type":"string"},"example":"daily"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","from":"2026-06-01","count":8,"access":"all-access","series":[{"date":"2026-06-01","views":314766231},{"date":"2026-06-02","views":311407635},{"date":"2026-06-03","views":308605746},{"date":"2026-06-04","views":303125887},{"date":"2026-06-05","views":311150207},{"date":"2026-06-06","views":310820458},{"date":"2026-06-07","views":327860680},{"date":"2026-06-08","views":341995000}],"source":"Wikimedia Pageviews","project":"en.wikipedia","granularity":"daily","total_views":2529731844},"meta":{"timestamp":"2026-06-10T13:59:42.131Z","request_id":"4b824cc6-1fa5-44c7-adc2-103dc9a72305"},"status":"ok","message":"Aggregate views retrieved successfully","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/compare":{"get":{"operationId":"get_v1_compare","tags":["Compare"],"summary":"Rank several articles by total views","description":"","parameters":[{"name":"articles","in":"query","required":true,"description":"Pipe/comma-separated article titles (2-6)","schema":{"type":"string"},"example":"Python_(programming_language)|Java_(programming_language)"},{"name":"project","in":"query","required":false,"description":"Wiki project","schema":{"type":"string"},"example":"en.wikipedia"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","from":"2026-06-01","count":2,"source":"Wikimedia Pageviews","project":"en.wikipedia","ranking":[{"days":8,"rank":1,"found":true,"title":"Python (programming language)","article":"Python_(programming_language)","total_views":53020},{"days":8,"rank":2,"found":true,"title":"Java (programming language)","article":"Java_(programming_language)","total_views":29365}]},"meta":{"timestamp":"2026-06-10T13:59:42.291Z","request_id":"ffe99c16-9a71-4e2b-b98d-afa18f5fb310"},"status":"ok","message":"Comparison completed successfully","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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Pageview data lags ~1-2 days; range/date defaults end 2 days back. project defaults to en.wikipedia (a bare lang code like 'de' becomes de.wikipedia).","source":"Wikimedia Pageviews REST API (wikimedia.org, live)","service":"wikitrends-api","endpoints":{"GET /v1/top":"Most-viewed articles for a day — the trending list (project=en.wikipedia, date=2026-06-08, limit=50, exclude_special=true).","GET /v1/meta":"This document.","GET /v1/article":"Daily/monthly pageview trend for one article (article=Cristiano_Ronaldo, project=en.wikipedia, from=2026-06-01, to=2026-06-08).","GET /v1/compare":"Rank several articles by total views (articles=Python_(programming_language)|Java_(programming_language), from=2026-06-01, to=2026-06-08).","GET /v1/aggregate":"A project's total pageviews over a range (project=en.wikipedia, from=2026-06-01, to=2026-06-08, granularity=daily)."},"description":"Live readership-trend data from the Wikimedia Pageviews API — the official measure of what the world is reading on Wikipedia and its sister projects. The top endpoint returns the most-viewed articles on any Wikipedia language edition for a given day (the daily trending list); the article endpoint returns the daily or monthly pageview trend for any single article over a date range; the aggregate endpoint returns a whole project's total pageviews over a range; the compare endpoint ranks several articles head-to-head by total views over a range. Live, no key, nothing stored. Distinct from Wikipedia content/article APIs — this is the pageview, trending and engagement signal: what people are actually reading and how it changes.","upstream_status":"ok","sample_top_count":1000},"meta":{"timestamp":"2026-06-10T13:59:42.433Z","request_id":"592eaae8-50dd-418c-9a62-b2470c83252f"},"status":"ok","message":"Meta","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":2000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":60000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":300000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4600,"monthly_call_quota":1500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wikitrends-api"}