{ "openapi": "3.0.1", "info": { "title": "Football Live Scores API - Fixtures, Standings, Odds, Stats", "description": "Football livescores, fixtures and results, league standings, topscorers, teams, players, squads, transfers, pre-match odds and predictions from the Sportmonks Football API 3.0 for 2,200+ leagues. Filter by date, league, team or state. Bring your own key.", "version": "0.1", "x-build-id": "FpjAvhg6ONxBMZjPP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~football-livescores-fixtures-standings-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-football-livescores-fixtures-standings-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/nabeelbaghoor~football-livescores-fixtures-standings-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-football-livescores-fixtures-standings-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/nabeelbaghoor~football-livescores-fixtures-standings-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-football-livescores-fixtures-standings-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": { "mode": { "title": "What to get", "enum": [ "liveScores", "fixturesByDate", "fixturesBetween", "fixturesById", "headToHead", "fixtureSearch", "leagues", "seasonSearch", "standings", "liveStandings", "topscorers", "teamSearch", "teamsById", "teamsBySeason", "playerSearch", "playersById", "squads", "transfers", "preMatchOdds", "predictions" ], "type": "string", "description": "Livescores reads matches in play now (or the whole livescores window). Fixtures by date, date range, ID, head to head and name return matches with teams, scores, state and league. Leagues, season search, team search and player search give the IDs other modes take. Standings, live standings and topscorers read league tables and goal charts. Teams, players and squads read profiles. Transfers reads the latest, a date range or one team. Pre-match odds and prediction probabilities read per fixture and are Sportmonks add-ons. Leagues and feeds depend on your Sportmonks plan.", "default": "fixturesByDate" }, "dates": { "title": "Match dates", "type": "array", "description": "Fixtures by date only. Calendar dates as YYYY-MM-DD, up to 31 per run. With a timezone set, Sportmonks reads each date in that timezone.", "items": { "type": "string" } }, "startDate": { "title": "Start date", "type": "string", "description": "Fixtures by date range and Transfers. YYYY-MM-DD. A fixtures range is 100 days at most." }, "endDate": { "title": "End date", "type": "string", "description": "Fixtures by date range and Transfers. YYYY-MM-DD, on or after the start date." }, "liveScope": { "title": "Livescores scope", "enum": [ "inplay", "all" ], "type": "string", "description": "Livescores only.", "default": "inplay" }, "searchQueries": { "title": "Search names", "type": "array", "description": "Fixture, league, season, team and player search. One name per line, such as Celtic, Premier League, 2025/2026 or Tavernier.", "items": { "type": "string" } }, "leagueIds": { "title": "League IDs", "type": "array", "description": "Fixture modes and livescores (keeps only these leagues), season search (seasons of these leagues) and live standings (one table per league). Numeric Sportmonks league IDs from the Leagues mode, such as 501 for the Scottish Premiership.", "items": { "type": "string" } }, "seasonIds": { "title": "Season IDs", "type": "array", "description": "Standings, topscorers and teams by season. Numeric season IDs from Season search or the currentSeason column of Leagues.", "items": { "type": "string" } }, "teamIds": { "title": "Team IDs", "type": "array", "description": "Head to head (exactly two), fixtures by date range (one window per team), teams by ID, squads and transfers by team. Numeric team IDs from Team search.", "items": { "type": "string" } }, "playerIds": { "title": "Player IDs", "type": "array", "description": "Players by ID only. Numeric player IDs from Player search, squads or topscorers.", "items": { "type": "string" } }, "fixtureIds": { "title": "Fixture IDs", "type": "array", "description": "Fixtures by ID (50 per request), pre-match odds and prediction probabilities. Numeric fixture IDs from any fixture mode.", "items": { "type": "string" } }, "countryIds": { "title": "Country IDs", "type": "array", "description": "Leagues (leagues of these countries) and team search and teams by season (keeps only teams from these countries). Numeric Sportmonks country IDs, such as 462 for England.", "items": { "type": "string" } }, "fixtureState": { "title": "Match state", "enum": [ "any", "notStarted", "live", "finished", "postponed" ], "type": "string", "description": "Fixture modes and livescores. Filters by the documented Sportmonks fixture state IDs.", "default": "any" }, "order": { "title": "Order", "enum": [ "asc", "desc" ], "type": "string", "description": "Fixtures by date, date range and fixture search.", "default": "asc" }, "marketIds": { "title": "Odds market IDs", "type": "array", "description": "Pre-match odds only. Keeps these markets, such as 1 for the match winner (1X2) market.", "items": { "type": "string" } }, "bookmakerIds": { "title": "Bookmaker IDs", "type": "array", "description": "Pre-match odds only. Keeps these bookmakers.", "items": { "type": "string" } }, "transferTypeIds": { "title": "Transfer type IDs", "type": "array", "description": "Transfers only. Keeps these Sportmonks transfer type IDs, such as 219 and 220.", "items": { "type": "string" } }, "timezone": { "title": "Timezone", "type": "string", "description": "Optional IANA timezone for kick off times, such as Europe/London or America/New_York. Defaults to UTC." }, "includes": { "title": "Includes", "type": "string", "description": "Optional. Sportmonks includes separated by semicolons, replacing the defaults, such as participants;scores;events;statistics for fixtures. Each mode adds team, league, player or market names by default. Some includes are plan add-ons." }, "plainRecords": { "title": "Plain records (no includes)", "type": "boolean", "description": "Sends no includes, so rows carry IDs but no names. Use it when your plan refuses an include.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops after this many rows. Each page of 50 rows is one Sportmonks API call.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Pacing ceiling. Sportmonks limits calls per entity per hour (2,000 to 5,000 by plan).", "default": 120 }, "apiKey": { "title": "API key (Sportmonks API token)", "type": "string", "description": "Your own Sportmonks API token, created in MySportmonks under API, Tokens. It is sent only to api.sportmonks.com in the Authorization header and never logged." } } }, "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 } } } } } } } } } }