{ "openapi": "3.0.1", "info": { "title": "Wikipedia Pageview Spikes", "description": "Find Wikipedia articles whose daily views spiked: article, wiki, date, views, normal level (median of prior days), spike ratio and rank, from Wikimedia's official pageview statistics. Any language or wiki, one day or a range. For trend, news and content research.", "version": "0.1", "x-build-id": "eZ9Hxbrk1L98QrLqt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automatic~wikipedia-pageview-spikes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automatic-wikipedia-pageview-spikes", "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/automatic~wikipedia-pageview-spikes/runs": { "post": { "operationId": "runs-sync-automatic-wikipedia-pageview-spikes", "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/automatic~wikipedia-pageview-spikes/run-sync": { "post": { "operationId": "run-sync-automatic-wikipedia-pageview-spikes", "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": { "projects": { "title": "Wikis", "type": "array", "description": "Wikis to scan: a language code ('en', 'de', 'ja'), a project such as 'en.wikipedia', 'fr.wiktionary' or 'commons.wikimedia', or a wiki address. Up to 10.", "default": [ "en.wikipedia" ], "items": { "type": "string" } }, "date": { "title": "Date", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Day to report (UTC), YYYY-MM-DD. Leave empty for the latest day with published statistics (usually yesterday)." }, "lastNDays": { "title": "Number of days", "minimum": 1, "maximum": 31, "type": "integer", "description": "Report this many days, ending on Date (or the latest day). 1 = a single day.", "default": 1 }, "baselineDays": { "title": "Baseline days", "minimum": 3, "maximum": 30, "type": "integer", "description": "An article's normal level is the median of its daily views over this many days before the reported day.", "default": 7 }, "minSpikeRatio": { "title": "Minimum spike ratio", "minimum": 1, "maximum": 10000, "type": "number", "description": "Only report articles whose views are at least this many times their normal level, e.g. 3 or 2.5.", "default": 3 }, "minViews": { "title": "Minimum views", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Ignore articles with fewer views than this on the reported day.", "default": 1000 }, "access": { "title": "Platform", "enum": [ "all-access", "desktop", "mobile-web", "mobile-app" ], "type": "string", "description": "Which readers to count.", "default": "all-access" }, "excludeSpecialPages": { "title": "Articles only", "type": "boolean", "description": "Leave out the main page, search and other special pages, and pages outside the article space (talk, user, project, file, category, portal pages).", "default": true }, "exactBaseline": { "title": "Exact normal level", "type": "boolean", "description": "Read the daily views of the strongest spikes whose normal level is otherwise only known as an upper limit (articles that were not among the day's 1,000 most viewed pages every day). Slower: about 10 articles a minute.", "default": true }, "maxLookups": { "title": "Exact lookups", "minimum": 0, "maximum": 1000, "type": "integer", "description": "At most this many articles get their exact daily views per run (about 10 a minute). The rest keep the estimated normal level, marked with baselineIsUpperBound. When a day's statistics are missing for a wiki, only articles with exact daily views are returned for the days that need it.", "default": 10 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum spikes returned, strongest first.", "default": 20 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }