{ "openapi": "3.0.1", "info": { "title": "Wikipedia Trends Scraper: Top Articles by Country", "description": "What every country is looking up on Wikipedia: daily top 1000 most-viewed articles per country or language, with rank movement between runs, plus daily view timeseries for any article. Official Wikimedia API, real view counts. For SEO, content, news and market signals. Keyless.", "version": "0.1", "x-build-id": "ipJnjBDc5zODnTuOm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~wikipedia-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-wikipedia-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapemint~wikipedia-trends-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-wikipedia-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapemint~wikipedia-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-wikipedia-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "top", "timeseries" ], "type": "string", "description": "\"Top articles\" returns a ranked chart per country or language project for one day. \"Article timeseries\" returns daily views per article over a date range.", "default": "top" }, "countries": { "title": "Countries (top mode)", "type": "array", "description": "ISO country codes, e.g. US, GB, DE, IN, BR, KE. One chart per country (all languages combined).", "default": [ "US", "GB" ], "items": { "type": "string" } }, "projects": { "title": "Wiki projects (top mode, optional)", "type": "array", "description": "Language projects instead of / in addition to countries, e.g. en.wikipedia, de.wikipedia, ja.wikipedia. One chart per project (worldwide views).", "default": [], "items": { "type": "string" } }, "date": { "title": "Date (top mode, optional)", "type": "string", "description": "YYYY-MM-DD. Empty = latest published day (stats lag about one day; the actor steps back automatically).", "default": "" }, "topN": { "title": "Chart depth (top mode)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many ranked articles per chart (API serves up to 1000).", "default": 50 }, "excludeSpecialPages": { "title": "Exclude non-article pages (top mode)", "type": "boolean", "description": "Skip Main Page, search pages and other non-article namespaces so charts contain real topics.", "default": true }, "compareWithPrevious": { "title": "Compare with previous run (top mode)", "type": "boolean", "description": "Remember ranks between runs and report previousRank, rankChange and isNew. Turn on with a schedule for daily movement tracking.", "default": true }, "articles": { "title": "Articles (timeseries mode)", "type": "array", "description": "Article titles exactly as on Wikipedia, e.g. Bitcoin, Taylor Swift, ChatGPT.", "default": [], "items": { "type": "string" } }, "project": { "title": "Wiki project (timeseries mode)", "type": "string", "description": "Which language edition to read views from, e.g. en.wikipedia, es.wikipedia.", "default": "en.wikipedia" }, "daysBack": { "title": "Days back (timeseries mode)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Length of the daily view history per article (up to 365).", "default": 30 }, "maxRows": { "title": "Max rows per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on rows returned. Controls total cost.", "default": 500 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }