{ "openapi": "3.0.1", "info": { "title": "Flashscore Match Stats: Player Stats, Lineups, xG", "description": "Scrape Flashscore match details: 100 stats per footballer (xG, xA, passes, duels), box scores for basketball and hockey, lineups with ratings, team stats by period, incidents, referee and attendance. Whole leagues or teams in one run. No API key.", "version": "1.0", "x-build-id": "vqhwAESNxjETzFGhF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/incognito_mode~flashscore-match-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-incognito_mode-flashscore-match-stats-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/incognito_mode~flashscore-match-stats-scraper/runs": { "post": { "operationId": "runs-sync-incognito_mode-flashscore-match-stats-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/incognito_mode~flashscore-match-stats-scraper/run-sync": { "post": { "operationId": "run-sync-incognito_mode-flashscore-match-stats-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": { "matchUrls": { "title": "Match URLs or ids", "type": "array", "description": "Flashscore match pages in any URL form (https://www.flashscore.com/match/j52jHsN8/, the long .../match/football/brighton-2XrRecc3/arsenal-hA1Zm19f/?mid=j52jHsN8 form, or any Flashscore edition), or bare 8-character match ids.", "items": { "type": "string" } }, "leagueUrls": { "title": "League or season URLs", "type": "array", "description": "A league page for the current season (https://www.flashscore.com/football/england/premier-league/) or a past season (.../premier-league-2024-2025/). Sub-pages such as .../results/ work too.", "items": { "type": "string" } }, "teamUrls": { "title": "Team URLs", "type": "array", "description": "A team page, e.g. https://www.flashscore.com/team/arsenal/hA1Zm19f/. Gives the team's newest finished matches in every competition.", "items": { "type": "string" } }, "maxMatchesPerSource": { "title": "Matches per league or team", "minimum": 0, "type": "integer", "description": "Newest finished matches to scrape from each league or team URL. 0 = every finished match (a whole Premier League season is 380).", "default": 10 }, "dateFrom": { "title": "From date", "type": "string", "description": "Only league and team matches played on or after this day (UTC), e.g. 2026-08-01." }, "dateTo": { "title": "To date", "type": "string", "description": "Only league and team matches played on or before this day (UTC)." }, "include": { "title": "Data to collect", "type": "array", "description": "Every match row has the score, period scores, incidents (goals, cards, substitutions), referee, venue and attendance. Team statistics: every stat per period (xG, possession, shots ...). Lineups: one row per player with shirt number, position, rating and substitutions, plus formations and coaches. Player stats: about 100 stats per footballer (xG, xA, passes, duels, tackles ...) or the box score in basketball and hockey, added to the player rows. Missing players: injured and suspended players. Momentum: per-minute pressure graph (football). Commentary: the full text commentary. Head-to-head: both teams' recent matches and their previous meetings.", "items": { "type": "string", "enum": [ "statistics", "lineups", "playerStats", "missingPlayers", "momentum", "commentary", "headToHead" ], "enumTitles": [ "Team statistics", "Lineups", "Player stats", "Missing players", "Momentum", "Commentary", "Head-to-head" ] }, "default": [ "statistics", "lineups", "playerStats", "missingPlayers" ] }, "includeUnusedSubstitutes": { "title": "Include unused substitutes", "type": "boolean", "description": "Also add a player row for substitutes who did not come on.", "default": false }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Stop after this many dataset rows in total (match rows plus player rows).", "default": 10000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: Flashscore does not block by IP. The Actor escalates to Apify proxies automatically if it is ever refused.", "default": { "useApifyProxy": 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 } } } } } } } } } }