{ "openapi": "3.0.1", "info": { "title": "UK Bookmaker Odds API with Exchange Lay Prices", "description": "Pre-match odds from UK and Irish bookmakers, bet365 included, with Betfair, Smarkets, Matchbook and BETDAQ lay prices, read from the OddsRelay API with your own key into a dataset you can export.", "version": "0.1", "x-build-id": "6s7HNirhEZbCMhO4D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oddsrelay~uk-bookmaker-odds-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oddsrelay-uk-bookmaker-odds-api", "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/oddsrelay~uk-bookmaker-odds-api/runs": { "post": { "operationId": "runs-sync-oddsrelay-uk-bookmaker-odds-api", "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/oddsrelay~uk-bookmaker-odds-api/run-sync": { "post": { "operationId": "run-sync-oddsrelay-uk-bookmaker-odds-api", "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": { "apiKey": { "title": "OddsRelay API key", "type": "string", "description": "Your own key from your OddsRelay account. Apify stores it encrypted; the Actor sends it only to api.oddsrelay.io, in the Authorization header, and never logs it or saves it to the dataset. Leave it empty to list coverage, which needs no key." }, "mode": { "title": "What to fetch", "enum": [ "odds", "coverage" ], "type": "string", "description": "Odds saves prices from the board you pick. Coverage saves one row per board, sport and bookmaker, so you can see what is on offer before you spend anything.", "default": "odds" }, "board": { "title": "Board", "enum": [ "standard", "each-way", "extra-place", "bog", "dutching", "2up", "raw" ], "type": "string", "description": "Which OddsRelay board to read in Odds mode. The README explains each one.", "default": "standard" }, "sports": { "title": "Sports", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Sport keys such as soccer, horse_racing or tennis. A competition key, as the OddsRelay docs list them, narrows it further. Up to 20.", "items": { "type": "string", "pattern": "^[a-z0-9_.-]+$" } }, "bookmakers": { "title": "Bookmakers", "maxItems": 40, "uniqueItems": true, "type": "array", "description": "Bookmaker keys in lowercase, such as bet365, william_hill or ladbrokes. On the Raw and Dutching boards exchange keys work here too. Up to 40. Run Coverage to see every key.", "items": { "type": "string", "pattern": "^[a-z0-9_.-]+$" } }, "markets": { "title": "Markets", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Market keys such as h2h or totals. Leave empty for every market on the board. Up to 20. Odds mode only.", "items": { "type": "string", "pattern": "^[a-z0-9_.-]+$" } }, "maxTokens": { "title": "Most tokens this run may spend", "minimum": 0, "type": "integer", "description": "Every call is priced first, which costs nothing. The run stops before any call that would take its total above this number, so it never spends more. Raw pages are priced one by one.", "default": 500 } } }, "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 } } } } } } } } } }