{ "openapi": "3.0.1", "info": { "title": "Flashscore Scraper - Results, Fixtures & Live Scores", "description": "Scrape Flashscore match results, fixtures and live scores across 28 sports: competition, country, UTC kickoff, final and live score, winner, period-by-period breakdown and both teams. Any date within today plus or minus 7 days. No login, one flat price.", "version": "0.1", "x-build-id": "gFdhW7bEqCMQzoVLq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cirkit~flashscore-results-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cirkit-flashscore-results-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/cirkit~flashscore-results-scraper/runs": { "post": { "operationId": "runs-sync-cirkit-flashscore-results-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/cirkit~flashscore-results-scraper/run-sync": { "post": { "operationId": "run-sync-cirkit-flashscore-results-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", "required": [ "sports" ], "properties": { "sports": { "title": "Sports", "minItems": 1, "type": "array", "description": "Which sports to collect. Every sport you pick is fetched for every day in the date range, so two sports across three days is six requests. Football and tennis carry the most fixtures by far.", "items": { "type": "string", "enum": [ "football", "tennis", "basketball", "hockey", "american-football", "baseball", "handball", "rugby-union", "rugby-league", "volleyball", "cricket", "darts", "snooker", "table-tennis", "badminton", "futsal", "floorball", "bandy", "boxing", "mma", "beach-volleyball", "beach-soccer", "water-polo", "field-hockey", "aussie-rules", "netball", "pesapallo", "esports" ], "enumTitles": [ "Football / Soccer", "Tennis", "Basketball", "Ice hockey", "American football", "Baseball", "Handball", "Rugby union", "Rugby league", "Volleyball", "Cricket", "Darts", "Snooker", "Table tennis", "Badminton", "Futsal", "Floorball", "Bandy", "Boxing", "MMA", "Beach volleyball", "Beach soccer", "Water polo", "Field hockey", "Aussie rules", "Netball", "Pesapallo", "Esports" ] }, "default": [ "football" ] }, "dateFrom": { "title": "Date from", "type": "string", "description": "First day to collect, as YYYY-MM-DD in UTC. You can also type a day offset such as -3 for three days ago or 0 for today, which is what you want on a schedule so the input never goes stale. Leave empty for today.", "default": "" }, "dateTo": { "title": "Date to", "type": "string", "description": "Last day to collect, same format as Date from. Leave empty to collect only the Date from day. Flashscore serves today plus or minus 7 days; anything outside that is trimmed and the run says so.", "default": "" }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Hard cap on the number of match rows. Set to 0 for no limit. You are charged per row, so this is also your budget control. A single day of football is roughly 500 matches worldwide.", "default": 1000 }, "matchStatus": { "title": "Match status", "type": "array", "description": "Keep only matches in these states. Scheduled means it has not started, live means it is in progress right now, finished means it is over. Leave empty for all three. Filters run before billing.", "items": { "type": "string", "enum": [ "scheduled", "live", "finished" ], "enumTitles": [ "Scheduled", "Live", "Finished" ] }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Keep only competitions from these countries, one per line, for example \"England\", \"Spain\", \"USA\". Matched as a case-insensitive substring against Flashscore's own country label. Leave empty for worldwide.", "default": [], "items": { "type": "string" } }, "competitions": { "title": "Competitions", "type": "array", "description": "Keep only these competitions, one per line, for example \"Premier League\", \"NBA\", \"Champions League\". Matched as a case-insensitive substring, so \"cup\" keeps every cup. Leave empty for all.", "default": [], "items": { "type": "string" } }, "teams": { "title": "Teams or players", "type": "array", "description": "Keep only matches where either side matches one of these, one per line, for example \"Arsenal\", \"Djokovic\". Matched as a case-insensitive substring against both participants. Leave empty for all.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. The default datacenter pool is enough for Flashscore and is the cheapest option; residential works too if you ever need it.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }