Top countries reading a project
Changed onCountry-level reader distribution for a Wikimedia project in a given month. Wikimedia publishes view counts as privacy-bucketed string ranges (e.g. 1000000000-9999999999) plus a numeric ceiling views_ceil. Country-scoped data carries a 2-3 day publishing lag beyond the usual 1-day pageview lag. Sourced from the Wikimedia Foundation Analytics Query Service (CC0).
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/news/wikipedia/pageviews/top-by-country
- Auth: API key in header x-api-key
Query parameters
Wikimedia project domain (e.g. en.wikipedia, ja.wikipedia).
Access method filter (all-access, desktop, mobile-app, mobile-web).
Year of the ranking month.
Month number (1-12).
Response
Countries ranked by reader volume for the requested project-month.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"data_age_days": 8.532,
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
],
"stale_since": "2026-09-08T12:00:00Z",
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
added the non-success response with the status
- info