{ "openapi": "3.0.1", "info": { "title": "Flashscore Scraper – Football, Tennis & Basketball Live Scores", "description": "Flashscore scraper for live scores, fixtures and results in football, tennis, basketball, ice hockey and 25+ other sports. Period and set scores, match statistics, goals, cards and incidents. Fast, no browser, pay only per match.", "version": "1.0", "x-build-id": "hrKe9X6pZSg7O0D98" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/openharvest~flashscore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-openharvest-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/openharvest~flashscore-scraper/runs": { "post": { "operationId": "runs-sync-openharvest-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/openharvest~flashscore-scraper/run-sync": { "post": { "operationId": "run-sync-openharvest-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 scrape. You can select several.", "items": { "type": "string", "enum": [ "football", "tennis", "basketball", "hockey", "american-football", "baseball", "handball", "volleyball", "rugby-union", "rugby-league", "cricket", "darts", "snooker", "esports", "table-tennis", "badminton", "beach-volleyball", "futsal", "floorball", "bandy", "water-polo", "field-hockey", "aussie-rules", "beach-soccer", "netball", "mma", "boxing", "pesapallo", "kabaddi" ], "enumTitles": [ "Football (soccer)", "Tennis", "Basketball", "Ice hockey", "American football", "Baseball", "Handball", "Volleyball", "Rugby union", "Rugby league", "Cricket", "Darts", "Snooker", "eSports", "Table tennis", "Badminton", "Beach volleyball", "Futsal", "Floorball", "Bandy", "Water polo", "Field hockey", "Aussie rules", "Beach soccer", "Netball", "MMA", "Boxing", "Pesapallo", "Kabaddi" ] }, "default": [ "football" ] }, "dayOffsetFrom": { "title": "From day (offset from today)", "minimum": -7, "maximum": 7, "type": "integer", "description": "First day to scrape, relative to today: 0 = today, -1 = yesterday, 1 = tomorrow. Flashscore provides data from -7 (one week ago) to +7 (one week ahead).", "default": 0 }, "dayOffsetTo": { "title": "To day (offset from today)", "minimum": -7, "maximum": 7, "type": "integer", "description": "Last day to scrape (inclusive), relative to today. Leave empty to scrape only the 'From day'. Example: From -7 To -1 = results of the whole last week." }, "onlyLive": { "title": "Only live matches", "type": "boolean", "description": "Return only matches that are in progress right now. Overrides the day range.", "default": false }, "statusFilter": { "title": "Match status", "type": "array", "description": "Keep only matches with these statuses. Leave empty for all.", "items": { "type": "string", "enum": [ "scheduled", "live", "finished", "postponed", "cancelled", "abandoned", "interrupted" ], "enumTitles": [ "Scheduled (fixtures)", "Live", "Finished (results)", "Postponed", "Cancelled", "Abandoned", "Interrupted" ] }, "default": [] }, "tournamentFilter": { "title": "Tournament / country filter", "type": "string", "description": "Keep only matches whose tournament or country contains this text (case-insensitive). Separate several with commas, e.g. 'Premier League, LaLiga, Serie A' or 'ENGLAND, SPAIN'." }, "teamFilter": { "title": "Team / player filter", "type": "string", "description": "Keep only matches where the home or away team (or tennis player) contains this text. Separate several with commas, e.g. 'Real Madrid, Barcelona'." }, "includeMatchDetails": { "title": "Include match details (statistics, incidents)", "type": "boolean", "description": "For each match also download match statistics (possession, shots, aces, ...), incidents (goals, cards, substitutions, assists) and match info (referee, venue). Charged as an extra 'match-details' event per match and makes the run slower.", "default": false }, "maxItems": { "title": "Max matches", "minimum": 0, "type": "integer", "description": "Maximum number of matches to save. 0 = no limit.", "default": 50 }, "timezoneOffset": { "title": "Time zone offset (hours from UTC)", "minimum": -12, "maximum": 14, "type": "integer", "description": "Defines where a 'day' starts and ends. 0 = UTC days. Example: 1 for London summer time, -5 for New York. Start times in the output are always in UTC (ISO 8601).", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed. Use Apify Proxy if you get blocked.", "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 } } } } } } } } } }