{ "openapi": "3.0.1", "info": { "title": "ESPN Scores, Schedules & Odds Scraper", "description": "Collect ESPN fixtures, live and final scores, team records, venue and broadcast for the NFL, NBA, NHL, MLB, college sports, soccer and UFC, with the sportsbook moneyline, spread and total ESPN shows for each game (opening and current). Optional standings, teams, rosters and futures.", "version": "0.1", "x-build-id": "BKq8VwO06tuTC4h19" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automatic~espn-sports/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automatic-espn-sports", "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/automatic~espn-sports/runs": { "post": { "operationId": "runs-sync-automatic-espn-sports", "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/automatic~espn-sports/run-sync": { "post": { "operationId": "run-sync-automatic-espn-sports", "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", "uniqueItems": true, "type": "array", "description": "Leagues to collect. Leave empty to collect the default scope (NFL, NBA and MLB); that default run stops with a clear message when none of the three has a game in the date window. A run that sets no leagues, dates or maximum at all is a sample of at most 20 records.", "items": { "type": "string", "enum": [ "nfl", "ncaaf", "nba", "wnba", "ncaab", "ncaaw", "mlb", "nhl", "epl", "laliga", "seriea", "bundesliga", "ligue_1", "ucl", "uel", "mls", "liga_mx", "brasileirao", "argentina_primera", "eredivisie", "primeira_liga", "belgian_pro_league", "scottish_premiership", "super_lig", "chile_primera", "j1_league", "ufc" ], "enumTitles": [ "NFL (National Football League)", "NCAAF (NCAA Football (FBS))", "NBA (National Basketball Association)", "WNBA (Women's National Basketball Association)", "NCAAB (NCAA Men's Basketball (Division I))", "NCAAW (NCAA Women's Basketball (Division I))", "MLB (Major League Baseball)", "NHL (National Hockey League)", "English Premier League", "La Liga (Spanish La Liga)", "Serie A (Italian Serie A)", "Bundesliga (German Bundesliga)", "Ligue 1 (French Ligue 1)", "UEFA Champions League", "UEFA Europa League", "MLS (Major League Soccer)", "Liga MX (Mexican Liga MX)", "Brasileirao (Brazilian Serie A)", "Argentine Primera Division", "Eredivisie (Dutch Eredivisie)", "Primeira Liga (Portuguese Primeira Liga)", "Belgian Pro League", "Scottish Premiership", "Super Lig (Turkish Super Lig)", "Chilean Primera Division", "J1 League (Japanese J1 League)", "UFC (Ultimate Fighting Championship)" ] } }, "collect": { "title": "What to collect", "uniqueItems": true, "type": "array", "description": "events: fixtures and scores with the sportsbook lines shown for each game (one request per league per day). standings: league tables. teams: the league's teams. rosters: every team's players (one request per team, at most 3 leagues per run). futures: sportsbook futures boards such as the title winner or MVP, where they exist (NFL, NBA, NHL, MLB and college football and basketball had boards on 2026-11-10).", "items": { "type": "string", "enum": [ "events", "standings", "teams", "rosters", "futures" ], "enumTitles": [ "Events and scores", "Standings", "Teams", "Rosters", "Futures" ] }, "default": [ "events" ] }, "dateFrom": { "title": "First day", "type": "string", "description": "First game day to collect, as YYYY-MM-DD (US Eastern calendar day, the day the source lists games under). Leave both dates empty for today and the next 3 days. With only this date set, that single day is collected." }, "dateTo": { "title": "Last day", "type": "string", "description": "Last game day to collect, as YYYY-MM-DD. A window may cover at most 31 days, and leagues x days at most 120." }, "includeOdds": { "title": "Include sportsbook lines", "type": "boolean", "description": "Add the moneyline, spread and total shown for each game, with opening and current values. Games without published lines get an empty odds list.", "default": true }, "includeClosingOdds": { "title": "Look up lines for started and finished games", "type": "boolean", "description": "Game listings stop showing lines once a game starts. Turn this on to look up the opening and closing lines of started and finished games (one extra request per such game, at most 100 per run). Needs \"Include sportsbook lines\" on.", "default": false }, "includeAllCollegeGames": { "title": "All college games", "type": "boolean", "description": "For college football and basketball, collect every FBS / Division I game instead of only games involving ranked teams.", "default": true }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many dataset records in total, across events, standings rows, teams, roster athletes and futures selections. Left empty it is 500, or 20 for a run that also sets no leagues or dates (a sample)." }, "requestDelaySecs": { "title": "Delay between requests", "minimum": 0.25, "maximum": 10, "type": "number", "description": "Seconds between request starts. The default of 1 keeps the run to about one request per second.", "default": 1 } } }, "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 } } } } } } } } } }