{ "openapi": "3.0.1", "info": { "title": "Sports Data: NFL, NBA, MLB, NHL & Football Scores", "description": "Scores, schedules, player box scores, standings, teams and rosters for NFL, NBA, WNBA, MLB, NHL, college, Premier League, LaLiga, Bundesliga, Serie A, Ligue 1, Champions League, MLS, F1, tennis, golf and UFC. Team and date filters, odds where shown; only-new for finals.", "version": "0.3", "x-build-id": "vJxHhAUxB23hUUITA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~sports-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-sports-data", "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/tacps126~sports-data/runs": { "post": { "operationId": "runs-sync-tacps126-sports-data", "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/tacps126~sports-data/run-sync": { "post": { "operationId": "run-sync-tacps126-sports-data", "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": { "leagues": { "title": "Leagues", "type": "array", "description": "One or more leagues. Box scores, teams and rosters cover team sports; standings also cover F1 (drivers, constructors) and ATP/WTA (singles rankings).", "items": { "type": "string", "enum": [ "nfl", "ncaaf", "nba", "wnba", "ncaab", "mlb", "nhl", "premier-league", "championship", "la-liga", "bundesliga", "serie-a", "ligue-1", "eredivisie", "primeira-liga", "champions-league", "europa-league", "mls", "liga-mx", "f1", "atp", "wta", "pga", "ufc" ], "enumTitles": [ "NFL", "NCAA Football (FBS)", "NBA", "WNBA", "NCAA Men's Basketball (D-I)", "MLB", "NHL", "Premier League", "EFL Championship", "LaLiga", "Bundesliga", "Serie A", "Ligue 1", "Eredivisie", "Primeira Liga", "UEFA Champions League", "UEFA Europa League", "MLS", "Liga MX", "Formula 1", "ATP tennis", "WTA tennis", "PGA Tour golf", "UFC" ] }, "default": [ "nba" ] }, "dataType": { "title": "What to get", "enum": [ "games", "boxScores", "odds", "standings", "teams", "rosters" ], "type": "string", "description": "Games give scores, status, venue, TV, team records, leaders, key events (goals, cards) and odds where shown. Odds give opening and current (closing after the game) moneyline, spread and total per sportsbook, fair win probability, line movement and, for finished games, which side covered and whether the total went over.", "default": "games" }, "daysBack": { "title": "Days back", "minimum": 0, "type": "integer", "description": "1 = yesterday and today.", "default": 1 }, "daysAhead": { "title": "Days ahead", "minimum": 0, "type": "integer", "description": "Upcoming fixtures, e.g. 7 for the next week's schedule.", "default": 0 }, "dateFrom": { "title": "From date", "type": "string", "description": "YYYY-MM-DD; replaces Days back." }, "dateTo": { "title": "To date", "type": "string", "description": "YYYY-MM-DD; replaces Days ahead. Up to about one season per run." }, "gameStatus": { "title": "Game status", "enum": [ "any", "final", "live", "scheduled" ], "type": "string", "description": "Box scores always use finished games.", "default": "any" }, "teams": { "title": "Teams", "type": "array", "description": "Team or player names or abbreviations, e.g. Lakers, KC, Arsenal, Sinner. Empty = all.", "items": { "type": "string" } }, "matchType": { "title": "Tennis draw", "enum": [ "any", "singles", "doubles" ], "type": "string", "description": "Tennis matches only: singles, doubles or both.", "default": "any" }, "season": { "title": "Season (standings)", "minimum": 1990, "type": "integer", "description": "The season's year as ESPN numbers it, e.g. 2026 for the 2025-26 NBA season. Empty = current." }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Most rows returned per run.", "default": 1000 }, "onlyNew": { "title": "Only new", "type": "boolean", "description": "Schedule the Actor and each run returns only what earlier runs did not deliver. A game comes again when its status changes (scheduled, live, final), so a daily run with Game status = Final gives each result once.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the \"only new\" history, so several monitors can run side by side." }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "default": 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 } } } } } } } } } }