{ "openapi": "3.0.1", "info": { "title": "Sports Odds Scraper: Football Odds Comparison by Bookmaker", "description": "Pre-match betting odds from BetExplorer, bookmaker by bookmaker: football (soccer) 1X2, Asian handicap and over/under, plus tennis, basketball, ice hockey, baseball, volleyball and handball. Every league listed, NHL, NBA and MLB included. A proxy country picks the books, e.g. 15 UK ones. No API key.", "version": "0.1", "x-build-id": "1OooeCzDMVR5PJXwk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thatmike1~sports-odds-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thatmike1-sports-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/thatmike1~sports-odds-scraper/runs": { "post": { "operationId": "runs-sync-thatmike1-sports-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/thatmike1~sports-odds-scraper/run-sync": { "post": { "operationId": "run-sync-thatmike1-sports-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": { "sport": { "title": "Sport", "enum": [ "football", "basketball", "tennis", "hockey", "baseball", "volleyball", "handball" ], "type": "string", "description": "One run covers one sport, across every league BetExplorer lists for it: football (soccer) from the Premier League and LaLiga down to lower divisions worldwide, NHL and KHL for ice hockey, NBA and European cups for basketball, MLB, KBO and NPB for baseball, ATP, WTA, Challenger and ITF for tennis. Football, ice hockey and handball are three-way (1X2, with a draw); the rest are two-way (home/away).", "default": "football" }, "days": { "title": "Days", "type": "array", "description": "Which days to scrape, as offsets from today: 0 is today, 1 is tomorrow, -1 is yesterday. Example: [0, 1, 2] for the next three days in one run. The source serves 7 days either side of today; anything further out is ignored.", "default": [ 0, 1 ] }, "markets": { "title": "Markets", "type": "array", "description": "Which markets to return per bookmaker. Moneyline (1X2 or home/away) is always included, because it is what identifies a bookmaker as quoting the event at all. Spread (Asian handicap) and total (over/under) each add one request per event; for spreads and totals you get the main line, the one most bookmakers quote.", "items": { "type": "string", "enum": [ "moneyline", "spread", "total" ], "enumTitles": [ "Moneyline / 1X2", "Spread (Asian handicap)", "Total (over/under)" ] }, "default": [ "moneyline", "spread", "total" ] }, "status": { "title": "Event status", "enum": [ "scheduled", "all", "live", "finished" ], "type": "string", "description": "'Scheduled' returns pre-match odds on events that have not started. 'All events' adds live and finished ones, so you also get closing odds; 'Finished only' with days [-1] gives yesterday's closing prices.", "default": "scheduled" }, "maxItems": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many events with odds. Events no bookmaker quotes are skipped and not billed. Set to 0 for no limit, which returns the whole day for the sport (about 100 football events on a weekday when checked). There is no league filter, so to get one league set 0 and filter on the league field.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "This selects which country's bookmakers you get, because the source shows each visitor the books licensed where they are. Turn on Apify Proxy, pick the RESIDENTIAL group and set a country: GB returned 15 UK bookmakers on a test event (bet365, William Hill, Paddy Power, Betfred, Betway and more), DE returned 5 German ones, and no proxy returns 4 US-facing ones. It is not needed to get through: the source has no anti-bot challenge. Residential traffic is billed by Apify on your plan.", "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 } } } } } } } } } }