{ "openapi": "3.0.1", "info": { "title": "Flashscore Scraper: Live Scores, Results, Fixtures, All Sports", "description": "Scrape Flashscore matches for 29 sports, including football, tennis, basketball, hockey and baseball. Today, any day from 7 back to 7 ahead, or live now, or the results and fixtures of a team, player or league page. Scores, status, teams, league, start time. Optional events, stats, odds.", "version": "1.0", "x-build-id": "j2g0gxhlaBfPDOhcN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fernandosord~flashscore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fernandosord-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/fernandosord~flashscore-scraper/runs": { "post": { "operationId": "runs-sync-fernandosord-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/fernandosord~flashscore-scraper/run-sync": { "post": { "operationId": "run-sync-fernandosord-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 list. Leave empty (and give no page URLs below) to get today's football as an example.", "items": { "type": "string", "enum": [ "soccer", "tennis", "basketball", "hockey", "american-football", "baseball", "handball", "rugby-union", "rugby-league", "volleyball", "beach-volleyball", "cricket", "darts", "snooker", "table-tennis", "badminton", "mma", "boxing", "esports", "futsal", "floorball", "bandy", "aussie-rules", "water-polo", "field-hockey", "beach-soccer", "netball", "pesapallo", "kabaddi" ], "enumTitles": [ "Football (soccer)", "Tennis", "Basketball", "Hockey (ice hockey)", "American football", "Baseball", "Handball", "Rugby union", "Rugby league", "Volleyball", "Beach volleyball", "Cricket", "Darts", "Snooker", "Table tennis", "Badminton", "MMA", "Boxing", "Esports", "Futsal", "Floorball", "Bandy", "Aussie rules", "Water polo", "Field hockey", "Beach soccer", "Netball", "Pesapallo", "Kabaddi" ] } }, "mode": { "title": "Mode", "enum": [ "day", "live" ], "type": "string", "description": "Matches on a day (or a range of days), or only the matches that are live right now.", "default": "day" }, "dayOffsetFrom": { "title": "First day, offset from today", "minimum": -7, "maximum": 7, "type": "integer", "description": "0 is today, -1 yesterday, 1 tomorrow. Flashscore lists 7 days back and 7 days ahead. Ignored in live mode.", "default": 0 }, "dayOffsetTo": { "title": "Last day, offset from today", "minimum": -7, "maximum": 7, "type": "integer", "description": "Same scale as the first day. Leave equal to the first day for a single day. Every day in between is included.", "default": 0 }, "leagueFilters": { "title": "League or tournament filters", "type": "array", "description": "Optional. Keep only these leagues. Either a name (for example England: Premier League, or just Champions League) or a Flashscore league URL (https://www.flashscore.com/football/england/premier-league/). A name matches any league whose full name contains it. Applies to the sports above.", "items": { "type": "string" } }, "pageUrls": { "title": "Team, player or league page URLs", "type": "array", "description": "Optional. Flashscore pages whose results and fixtures you want, for example https://www.flashscore.com/team/arsenal/hA1Zm19f/ or https://www.flashscore.com/football/england/premier-league/. Works for teams, tennis players and leagues.", "items": { "type": "string" } }, "pageMatches": { "title": "What to take from those pages", "enum": [ "both", "results", "fixtures" ], "type": "string", "description": "Past results, upcoming fixtures, or both. Only used with the page URLs above.", "default": "both" }, "includeDetails": { "title": "Include match details", "type": "boolean", "description": "Adds the event timeline (goals, cards, substitutions, and similar), statistics for the whole match and each half, odds from several bookmakers and the round. Costs 3 to 4 extra requests per match, so runs are slower. Matches that have not started have odds only.", "default": false }, "maxMatches": { "title": "Max matches", "minimum": 1, "type": "integer", "description": "The Actor stops after this many matches in total. Every match saved is one billed result.", "default": 100 }, "timezoneOffset": { "title": "Time zone offset (hours)", "minimum": -11, "maximum": 12, "type": "integer", "description": "Decides where one day starts and ends in day mode, as hours from UTC. 0 is UTC, -5 is New York in winter, 1 is Berlin in winter. Start times in the output are always UTC.", "default": 0 }, "oddsCountryCode": { "title": "Odds country code", "type": "string", "description": "Two-letter country code. Flashscore shows different bookmakers per country, so this changes which bookmakers appear in the odds. Only used with match details.", "default": "US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Flashscore answered requests from Apify servers without a proxy in testing, so leave this off unless you see blocked requests." } } }, "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 } } } } } } } } } }