{ "openapi": "3.0.1", "info": { "title": "Flashscore Scraper — Live Scores, Results, Odds & Standings", "description": "Flashscore scraper API: live scores, fixtures and results for football, basketball, hockey, tennis and 25 more sports, with stats, lineups, odds and standings. JSON/CSV/Excel.", "version": "0.1", "x-build-id": "nkv5iCrVbmThsCMEv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/innolabs~flashscore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-innolabs-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/innolabs~flashscore-scraper/runs": { "post": { "operationId": "runs-sync-innolabs-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/innolabs~flashscore-scraper/run-sync": { "post": { "operationId": "run-sync-innolabs-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": { "mode": { "title": "What to scrape", "enum": [ "matches", "live", "details", "tournaments" ], "type": "string", "description": "Matches by date (fixtures, live scores and results for up to 15 days), live matches only, full details for specific matches, or leagues (standings table + results + fixtures).", "default": "matches" }, "sports": { "title": "Sports", "type": "array", "description": "Sports for 'Matches by date' and 'Live matches now'. Empty = football.", "items": { "type": "string", "enum": [ "football", "basketball", "hockey", "tennis", "american-football", "baseball", "volleyball", "handball", "rugby-union", "rugby-league", "cricket", "darts", "snooker", "table-tennis", "badminton", "esports", "aussie-rules", "futsal", "floorball", "bandy", "water-polo", "field-hockey", "beach-volleyball", "beach-soccer", "boxing", "mma", "netball", "pesapallo", "kabaddi" ], "enumTitles": [ "Football (soccer)", "Basketball", "Hockey (ice)", "Tennis", "American football", "Baseball", "Volleyball", "Handball", "Rugby Union", "Rugby League", "Cricket", "Darts", "Snooker", "Table tennis", "Badminton", "eSports", "Aussie rules", "Futsal", "Floorball", "Bandy", "Water polo", "Field hockey", "Beach volleyball", "Beach soccer", "Boxing", "MMA", "Netball", "Pesäpallo", "Kabaddi" ] } }, "dateFrom": { "title": "Date (from)", "type": "string", "description": "First day to scrape (UTC): YYYY-MM-DD, 'today', 'yesterday', 'tomorrow' or a relative day such as -3 or +2. Up to 7 days back and up to 7 days ahead.", "default": "today" }, "dateTo": { "title": "Date (to)", "type": "string", "description": "Last day to scrape (inclusive), same formats as 'Date (from)'. Leave empty for a single day." }, "status": { "title": "Match status", "enum": [ "any", "scheduled", "live", "finished" ], "type": "string", "description": "Keep only scheduled (fixtures), live or finished (results) matches. Finished includes walkovers, retirements and awarded matches.", "default": "any" }, "leagueQuery": { "title": "League or country contains", "type": "string", "description": "Optional case-insensitive filter on the league name or country, e.g. 'Premier League', 'England' or 'NBA'." }, "matchUrls": { "title": "Match URLs or ids", "type": "array", "description": "Flashscore match URLs (e.g. https://www.flashscore.com/match/football/argentinos-jrs-QuxS0ahA/atl-tucuman-KpqpxWko/?mid=d2pRAfVg) or 8-character match ids (e.g. d2pRAfVg). Every match item in this dataset has its id and url.", "items": { "type": "string" } }, "tournamentUrls": { "title": "League URLs", "type": "array", "description": "Flashscore league pages, e.g. https://www.flashscore.com/football/england/premier-league/ or https://www.flashscore.com/basketball/usa/nba/ (the /standings/, /results/ and /fixtures/ sub-pages work too). Past seasons work with their archive URL, e.g. .../premier-league-2024-2025/.", "items": { "type": "string" } }, "tournamentData": { "title": "League data", "type": "array", "description": "What to return for each league.", "items": { "type": "string", "enum": [ "standings", "results", "fixtures" ], "enumTitles": [ "Standings table", "Results", "Fixtures" ] }, "default": [ "standings", "results", "fixtures" ] }, "maxMatchesPerTournament": { "title": "Results / fixtures per league", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Maximum results and maximum fixtures per league (newest results and nearest fixtures first). 0 = standings only.", "default": 100 }, "includeDetails": { "title": "Add match details", "type": "boolean", "description": "Statistics (shots, possession, xG… per match and per period), lineups with formations, numbers and ratings, incidents (goals, assists, cards, substitutions), referee and venue.", "default": false }, "includeH2H": { "title": "Add head-to-head and form", "type": "boolean", "description": "Previous meetings of the two teams and each team's latest matches with scores and results.", "default": false }, "includeOdds": { "title": "Add bookmaker odds", "type": "boolean", "description": "Pre-match odds per bookmaker: match winner (1X2 or moneyline, current and opening), over/under lines and both teams to score, plus the best and average price.", "default": false }, "oddsCountry": { "title": "Odds country", "enum": [ "GB", "IE", "US", "CA", "AU", "DE", "FR", "IT", "ES", "PL", "CZ", "NL", "SE", "DK", "AT", "PT", "GR", "RO", "ZA", "NG", "KE", "IN", "MX", "CO" ], "type": "string", "description": "Bookmakers are country-specific. United Kingdom lists the most bookmakers; US odds are those offered in New Jersey, Canada's those in Ontario.", "default": "GB" }, "allOddsMarkets": { "title": "All odds markets", "type": "boolean", "description": "Also return every other market per bookmaker: half-time 1X2, handicaps, double chance, draw no bet, correct score, odd/even and more (much larger items).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on dataset items (matches and standings rows together). The run stops cleanly when reached.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed for normal use. Switch on Apify Proxy only if requests start failing.", "default": { "useApifyProxy": false } }, "debug": { "title": "Debug logging", "type": "boolean", "description": "Verbose logs for development.", "default": false } } }, "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 } } } } } } } } } }