{ "openapi": "3.0.1", "info": { "title": "Flashscore: Match Listings, Scores & Fixtures", "description": "Extract match listings from Flashscore for football and basketball. Filter by date (-7 to +7 days), match status, or league. Returns teams, scores, tournament, and match metadata.", "version": "0.0", "x-build-id": "ndyghfVW61BXQalyp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/extractify-labs~flashscore-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-extractify-labs-flashscore-extractor", "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/extractify-labs~flashscore-extractor/runs": { "post": { "operationId": "runs-sync-extractify-labs-flashscore-extractor", "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/extractify-labs~flashscore-extractor/run-sync": { "post": { "operationId": "run-sync-extractify-labs-flashscore-extractor", "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": [ "mode" ], "properties": { "mode": { "title": "Extraction mode", "enum": [ "score_mode" ], "type": "string", "description": "Select the type of data you want to extract.\n\n**Available Modes:**\n- **score_mode** - Finished, Live & Scheduled Matches: Extracts current scores and results based on your date and status filters. This is the equivalent of going to the homepage of Flashscore and getting all the matches listed there.", "default": "score_mode" }, "scoreModeOptions": { "title": "Score Mode Settings", "type": "object", "description": "Configure parameters specific to the '[score_mode] Finished, Live & Scheduled Matches' mode." }, "sports": { "title": "Target Sports", "type": "array", "description": "List the sports you want to scrape. Currently, 'Football' and 'Basketball' are supported.", "items": { "type": "string", "enum": [ "football", "basketball" ], "enumTitles": [ "Football (soccer)", "Basketball" ] }, "default": [ "football" ] }, "matchStatuses": { "title": "Match Status", "type": "array", "description": "Filter by match status. Use 'finished' for completed matches, 'scheduled' for upcoming ones, or 'live' for matches in progress at the time the actor runs. 'live' reflects status at the moment of extraction, not a real-time data stream.", "items": { "type": "string", "enum": [ "all", "finished", "live", "scheduled" ], "enumTitles": [ "All", "Finished", "Live", "Scheduled" ] }, "default": [ "all" ] }, "leagues": { "title": "League / Tournament Filter", "type": "array", "description": "Filter results to specific leagues or tournaments. Enter names as they appear on Flashscore (e.g. \"LaLiga\", \"Premier League\", \"Champions League\"). Matching is case-insensitive. Leave empty to return all leagues.", "items": { "type": "string" }, "default": [] }, "dayOffsets": { "title": "Days to fetch", "type": "array", "description": "Select the specific days you want to scrape relative to today (range: -7 to 7). For example: [0] for today, [-1, 0, 1] for yesterday, today, and tomorrow.", "items": { "type": "string", "enum": [ "-7", "-6", "-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "7 Days Ago (-7)", "6 Days Ago (-6)", "5 Days Ago (-5)", "4 Days Ago (-4)", "3 Days Ago (-3)", "2 Days Ago (-2)", "Yesterday (-1)", "Today (0)", "Tomorrow (+1)", "In 2 Days (+2)", "In 3 Days (+3)", "In 4 Days (+4)", "In 5 Days (+5)", "In 6 Days (+6)", "In 7 Days (+7)" ] }, "default": [ "-7", "-6", "-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7" ] }, "overallRules": { "title": "General Settings", "type": "object", "description": "Configure general settings, applicable to all modes." }, "maxItems": { "title": "Maximum Items", "minimum": 1, "type": "integer", "description": "Limit the maximum number of results to scrape. Leave blank to scrape all available data points." } } }, "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 } } } } } } } } } }