{ "openapi": "3.0.1", "info": { "title": "FlashScore Scraper Live", "description": "Scrape FlashScore live scores, fixtures, results, odds, and match events across 16 sports. In historical mode, enrich each match with up to 100 recent games per team, detailed statistics, incidents, and mutual H2H. Export analytics-ready sports data to JSON, CSV, Excel, or the Apify API.", "version": "0.1", "x-build-id": "C32WVjChPeOZy90Vb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/statanow~flashscore-scraper-live/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-statanow-flashscore-scraper-live", "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/statanow~flashscore-scraper-live/runs": { "post": { "operationId": "runs-sync-statanow-flashscore-scraper-live", "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/statanow~flashscore-scraper-live/run-sync": { "post": { "operationId": "run-sync-statanow-flashscore-scraper-live", "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", "required": [ "sport", "mode" ], "properties": { "dayOffsets": { "title": "Days to fetch", "type": "array", "description": "Choose which days to scrape. 0 = Today, -1 = Yesterday, 1 = Tomorrow. Select multiple days to scrape several dates.", "items": { "type": "string", "enum": [ "-7", "-6", "-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "7 Days Ago (-7)", "6 Days Ago (-6)", "5 Days Ago (-5)", "4 Days Ago (-4)", "3 Days Ago (-3)", "2 Days Ago (-2)", "Yesterday (-1)", "Today (0)", "Tomorrow (+1)", "In 2 Days (+2)", "In 3 Days (+3)", "In 4 Days (+4)", "In 5 Days (+5)", "In 6 Days (+6)", "In 7 Days (+7)" ] }, "default": [ "0" ] }, "sport": { "title": "Sport", "enum": [ "all", "football", "basketball", "american-football", "futsal", "rugby union", "rugby league", "handball", "baseball", "hockey", "cricket", "tennis", "volleyball", "badminton", "table-tennis", "darts", "snooker" ], "type": "string", "description": "Choose a sport for matches scraping.", "default": "football" }, "mode": { "title": "Output mode", "enum": [ "standard", "with-history" ], "type": "string", "description": "standard keeps the current live-only behavior; with-history additionally reads scheduler snapshots by match ID.", "default": "with-history" }, "historyFromYear": { "title": "Oldest historical year", "minimum": 1949, "maximum": 2100, "type": "integer", "description": "Include every historical match from January 1 of this year through today. Use 1949 for the full currently available depth.", "default": 1949 }, "workers": { "title": "Detail workers per sport", "minimum": 1, "maximum": 64, "type": "integer", "description": "Requested match-detail concurrency. In Live + history mode v4 applies a memory-aware safety cap based on ACTOR_MEMORY_MBYTES.", "default": 64 }, "sportConcurrency": { "title": "Parallel sports", "minimum": 1, "maximum": 16, "type": "integer", "description": "Requested parallel sports when sport=all. Live + history caps this to 1-2 on typical memory sizes to keep snapshots bounded.", "default": 16 }, "historyLookupConcurrency": { "title": "Historical lookup concurrency", "minimum": 1, "maximum": 64, "type": "integer", "description": "Requested KVS lookup concurrency. Live + history v4 applies a memory-aware cap and bounded streaming batches to prevent OOM.", "default": 64 }, "historyStorageRequestsPerSecond": { "title": "Historical storage requests per second", "minimum": 10, "maximum": 150, "type": "integer", "description": "Hidden global KVS pacing maximum kept below Apify's 200 requests/second limit.", "default": 150 } } }, "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 } } } } } } } } } }