{ "openapi": "3.0.1", "info": { "title": "ESPN Sports Scores Scraper 🏀 (games, odds, box scores)", "description": "ESPN scores, schedules, betting odds, box scores, standings, rosters and news for the NFL, NBA, MLB, NHL, NCAA, soccer, UFC, F1, tennis and golf. One flat row per game or player. No API key, no login.", "version": "0.1", "x-build-id": "rnjdn3tOXbYlrEYEO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~espn-sports-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-espn-sports-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/tagadanar~espn-sports-scraper/runs": { "post": { "operationId": "runs-sync-tagadanar-espn-sports-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/tagadanar~espn-sports-scraper/run-sync": { "post": { "operationId": "run-sync-tagadanar-espn-sports-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": { "mode": { "title": "What do you want?", "enum": [ "scores", "gameDetails", "standings", "teams", "rosters", "schedules", "news" ], "type": "string", "description": "Scores and schedule: one row per game with score, status, venue, TV and betting odds. Game details: box score, team stats, player stats, odds from every provider, injuries, win probability. Standings: league tables. Teams, Rosters, Team schedules and News cover the rest.", "default": "scores" }, "leagues": { "title": "Leagues", "type": "array", "description": "Pick one or more leagues. Soccer, college sports, UFC, Formula 1, tennis and golf are included. With nothing picked, paste ESPN links below instead.", "items": { "type": "string", "enum": [ "nfl", "nba", "wnba", "mlb", "nhl", "college-football", "mens-college-basketball", "womens-college-basketball", "college-baseball", "mens-college-hockey", "ufl", "cfl", "nba-development", "mls", "nwsl", "epl", "championship", "fa-cup", "carabao-cup", "la-liga", "copa-del-rey", "bundesliga", "bundesliga-2", "serie-a", "ligue-1", "eredivisie", "primeira-liga", "scottish-premiership", "super-lig", "liga-mx", "brasileirao", "argentina-primera", "saudi-pro-league", "j-league", "a-league", "ucl", "europa-league", "conference-league", "copa-libertadores", "concacaf-champions", "world-cup", "ufc", "pfl", "f1", "nascar", "indycar", "atp", "wta", "pga", "lpga", "dp-world-tour", "pll" ], "enumTitles": [ "NFL", "NBA", "WNBA", "MLB", "NHL", "NCAA football", "NCAA men's basketball", "NCAA women's basketball", "NCAA baseball", "NCAA men's hockey", "UFL", "CFL", "NBA G League", "MLS (Major League Soccer)", "NWSL", "Premier League (England)", "EFL Championship (England)", "FA Cup", "Carabao Cup (League Cup)", "La Liga (Spain)", "Copa del Rey", "Bundesliga (Germany)", "2. Bundesliga (Germany)", "Serie A (Italy)", "Ligue 1 (France)", "Eredivisie (Netherlands)", "Primeira Liga (Portugal)", "Scottish Premiership", "Super Lig (Turkey)", "Liga MX (Mexico)", "Brasileirao Serie A (Brazil)", "Liga Profesional (Argentina)", "Saudi Pro League", "J.League (Japan)", "A-League Men (Australia)", "UEFA Champions League", "UEFA Europa League", "UEFA Conference League", "Copa Libertadores", "Concacaf Champions Cup", "FIFA World Cup", "UFC", "PFL", "Formula 1", "NASCAR Cup Series", "IndyCar", "Tennis ATP (men)", "Tennis WTA (women)", "PGA Tour", "LPGA Tour", "DP World Tour", "Premier Lacrosse League" ] } }, "date": { "title": "Date", "type": "string", "description": "A day like 2026-01-05, or today, tomorrow, yesterday. Leave empty for ESPN's current scoreboard (today's games, or this week's for the NFL). Used by Scores and Game details." }, "dateTo": { "title": "Last date (optional)", "type": "string", "description": "Fill it to read every day from Date to this day, e.g. 2026-01-12. Up to 92 days per run." }, "gameStatus": { "title": "Games to keep", "enum": [ "all", "scheduled", "live", "final" ], "type": "string", "description": "Keep only games that are still to be played, are live right now, or are finished.", "default": "all" }, "urls": { "title": "ESPN links or game IDs", "type": "array", "description": "Paste espn.com links: a game or match page, a team page, or a scoreboard or standings page. A bare game ID needs its league in front, like nba/401810397. Links work in every mode.", "items": { "type": "string" } }, "teams": { "title": "Teams (Rosters and Team schedules)", "type": "array", "description": "Team names, abbreviations or ESPN team IDs, one per line, e.g. Lakers, BOS, 14. They are looked up in each league you picked. Leave empty to read every team of the league.", "items": { "type": "string" } }, "season": { "title": "Season", "minimum": 1990, "maximum": 2100, "type": "integer", "description": "Standings and Team schedules only. The season year ESPN uses (2025 is the 2025-26 season for the NBA, NHL and European soccer). Leave empty for the current season." }, "includePlayerStats": { "title": "Include player box score rows", "type": "boolean", "description": "Game details only. Adds one row per player per game (minutes, points, yards, shots and so on). Turn it off if you only want the game-level row.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops the run after this many rows (all row types together). You only pay for rows delivered.", "default": 1000 } } }, "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 } } } } } } } } } }