{ "openapi": "3.0.1", "info": { "title": "๐Ÿš€ Flashscore Odds Scraper ยท 2,500 Free Matches/Month", "description": "Flashscore Odds Scraper gets you betting odds โšก fast, ๐ŸŽฏ 100% accurate and ๐Ÿ” ridiculously detailed โ€” opening & current prices from 20+ bookmakers for 1X2, over/under, handicaps, BTTS & correct score. ๐Ÿ’ฐ $2 per 1,000 matches, no start fee. Scrape your first 2,500 matches free every month ๐Ÿš€", "version": "0.0", "x-build-id": "xac2reGlrMbkKBSmq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omkar-cloud~flashscore-odds-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omkar-cloud-flashscore-odds-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/omkar-cloud~flashscore-odds-scraper/runs": { "post": { "operationId": "runs-sync-omkar-cloud-flashscore-odds-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/omkar-cloud~flashscore-odds-scraper/run-sync": { "post": { "operationId": "run-sync-omkar-cloud-flashscore-odds-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": "Sports to scrape, by slug, like `football`, `tennis`, `basketball`, `hockey`, `american-football`, `baseball`, `handball`, `rugby-union`, `volleyball`, `cricket`, `darts`, `snooker`, `boxing`, `mma`, `esports` โ€” any of Flashscore's 37 sports with head-to-head matches works.", "items": { "type": "string" } }, "days": { "title": "Days", "type": "array", "description": "Days to scrape: `today`, `yesterday`, `tomorrow`, an offset from today between `-7` and `7`, or a date like `2026-09-19` inside that window. Empty = today.", "items": { "type": "string" } }, "status": { "title": "Match Status", "enum": [ "", "scheduled", "live", "finished" ], "type": "string", "description": "Keep only matches in one state โ€” `Scheduled` for pre-match prices, `Finished` for closing odds. Empty = every match of the day.", "default": "" }, "competitions": { "title": "Competitions", "type": "array", "description": "Keep only competitions whose name contains one of these, like `Premier League`, `ENGLAND: Premier League`, `LaLiga`, `NBA` or `Champions League` โ€” or paste the flashscore.com competition URL. Empty = every competition.", "items": { "type": "string" } }, "matches": { "title": "Matches", "type": "array", "description": "Specific matches, by Flashscore match id like `GCxZ2uHc` or a pasted flashscore.com match URL like `https://www.flashscore.com/match/GCxZ2uHc/`.", "items": { "type": "string" } }, "geo": { "title": "Bookmaker Country", "type": "string", "description": "2-letter country code deciding which bookmakers you get, like `GB` (20+ bookmakers), `US`, `DE`, `IN` or `BR`.", "default": "GB" }, "betTypes": { "title": "Markets", "type": "array", "description": "Markets to keep. Empty = every market the bookmakers price, which also includes draw no bet, European handicap and odd/even.", "items": { "type": "string", "enum": [ "home-draw-away", "home-away", "over-under", "both-teams-to-score", "double-chance", "asian-handicap", "correct-score", "half-time-full-time" ], "enumTitles": [ "1X2 (home / draw / away)", "Home / Away", "Over / Under", "Both Teams to Score", "Double Chance", "Asian Handicap", "Correct Score", "Half Time / Full Time" ] } }, "betScope": { "title": "Match Part", "enum": [ "", "full-time", "first-half", "second-half" ], "type": "string", "description": "Part of the match the prices cover. Empty = full time, first half and second half.", "default": "" }, "timezone": { "title": "Timezone", "type": "string", "description": "Timezone for kick-off times and for what counts as \"today\" โ€” an IANA name like `America/New_York` or an hour offset like `-4`. Empty = UTC." }, "maxResults": { "title": "Max Matches", "minimum": 1, "type": "integer", "description": "Maximum number of match rows with odds for the whole run. Use this to control your cost (1,000 matches = $2).", "default": 100 } } }, "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 } } } } } } } } } }