{ "openapi": "3.0.1", "info": { "title": "Flashscore Sports Results Scraper - Live Scores, 31 Sports", "description": "Flashscore scraper for 31 sports: one football day feed returned 460 tournaments and 1,815 matches in a single request. Football live scores API with tennis and basketball live scores over a 15-day window, 76 columns, field names from the site's own bundle. No browser, no proxy.", "version": "0.1", "x-build-id": "OYQpWt8brTXJocdPR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/snow_leo_data~flashscore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-snow_leo_data-flashscore-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/snow_leo_data~flashscore-scraper/runs": { "post": { "operationId": "runs-sync-snow_leo_data-flashscore-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/snow_leo_data~flashscore-scraper/run-sync": { "post": { "operationId": "run-sync-snow_leo_data-flashscore-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": { "sports": { "title": "Sports", "type": "array", "description": "Which sports to collect. 31 sports return a feed - measured by probing ids 1..45 from Apify servers. Pick 'all' for every one of them.", "items": { "type": "string", "enum": [ "all", "football", "tennis", "basketball", "hockey", "american-football", "baseball", "handball", "rugby-union", "floorball", "bandy", "futsal", "volleyball", "cricket", "darts", "snooker", "boxing", "aussie-rules", "rugby-league", "badminton", "water-polo", "golf", "field-hockey", "table-tennis", "beach-soccer", "mma", "pesapallo", "auto-racing", "moto-racing", "cycling", "horse-racing", "esports" ], "enumTitles": [ "All 31 sports", "Football", "Tennis", "Basketball", "Hockey", "American Football", "Baseball", "Handball", "Rugby Union", "Floorball", "Bandy", "Futsal", "Volleyball", "Cricket", "Darts", "Snooker", "Boxing", "Aussie Rules", "Rugby League", "Badminton", "Water Polo", "Golf", "Field Hockey", "Table Tennis", "Beach Soccer", "Mma", "Pesapallo", "Auto Racing", "Moto Racing", "Cycling", "Horse Racing", "Esports" ] }, "default": [ "football" ] }, "dayOffsets": { "title": "Days", "type": "array", "description": "Days relative to today: 0 is today, -1 yesterday, 3 in three days. The source serves -7..+7 and returns an empty body outside that - measured; days outside are dropped before any request.", "default": [ "0" ], "items": { "type": "string" } }, "matchStatuses": { "title": "Match statuses", "type": "array", "description": "Keep only these. Leave empty for all three.", "items": { "type": "string", "enum": [ "scheduled", "live", "finished" ], "enumTitles": [ "Scheduled", "Live", "Finished" ] }, "default": [] }, "tournamentContains": { "title": "Tournament contains", "type": "array", "description": "Keep matches whose tournament name contains any of these words, e.g. 'Premier League'.", "default": [], "items": { "type": "string" } }, "countryContains": { "title": "Country contains", "type": "array", "description": "Keep matches from these countries or regions, e.g. 'England'.", "default": [], "items": { "type": "string" } }, "teamContains": { "title": "Team or player contains", "type": "array", "description": "Keep matches where either side matches, e.g. 'Arsenal' or 'Djokovic'.", "default": [], "items": { "type": "string" } }, "includeHeadToHead": { "title": "Add head-to-head", "type": "boolean", "description": "Read previous meetings and recent form for every delivered match. One extra request per match, so it is off by default.", "default": false }, "includeOdds": { "title": "Add odds fields", "type": "boolean", "description": "Add the 1/X/2, handicap, over-under and moneyline numbers that travel in the same feed. Off by default.", "default": false }, "includeRawFields": { "title": "Add raw feed fields", "type": "boolean", "description": "Add every raw feed key with the constant name Flashscore's own bundle gives it. Useful for sport-specific values this Actor does not name yet.", "default": false }, "compactOutput": { "title": "Compact output", "type": "boolean", "description": "Drop empty fields from every row. Smaller CSV, friendlier to AI agents.", "default": false }, "onlyChanged": { "title": "Only changed since last run", "type": "boolean", "description": "Remember what was delivered and write only new or changed matches. Made for scheduled monitoring.", "default": false }, "emitUnchanged": { "title": "Emit unchanged too", "type": "boolean", "description": "With incremental mode on, still write matches that did not change, tagged UNCHANGED.", "default": false }, "monitorStoreName": { "title": "Memory store name", "type": "string", "description": "Named key-value store that holds the incremental memory. Change it to keep several schedules apart." }, "language": { "title": "Language", "enum": [ "en", "es", "de", "fr", "it", "pt", "pl", "tr", "ru" ], "type": "string", "description": "Language of tournament and participant names.", "default": "en" }, "maxItems": { "title": "Max rows", "minimum": 0, "type": "integer", "description": "Upper bound on DELIVERED rows, not on rows scanned. 0 means no limit.", "default": 200 }, "detailConcurrency": { "title": "Head-to-head concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel head-to-head requests.", "default": 8 } } }, "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 } } } } } } } } } }