{ "openapi": "3.0.1", "info": { "title": "ESPN Scraper: Live Scores, Odds & Box Scores API", "description": "ESPN sports data for NFL, NBA, MLB, NHL, college sports, top soccer leagues and UFC: live scores and schedules (filter by status, start time, TV network, home or away), betting odds, player box scores, standings, rosters, injuries and news.", "version": "0.1", "x-build-id": "J7uyOhsAQ4JmSKpRc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tindacloud~espn-sports-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tindacloud-espn-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/tindacloud~espn-sports-data/runs": { "post": { "operationId": "runs-sync-tindacloud-espn-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/tindacloud~espn-sports-data/run-sync": { "post": { "operationId": "run-sync-tindacloud-espn-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": "Leagues to collect.", "items": { "type": "string", "enum": [ "nfl", "college-football", "nba", "wnba", "mens-college-basketball", "womens-college-basketball", "mlb", "nhl", "eng.1", "esp.1", "ger.1", "ita.1", "fra.1", "usa.1", "mex.1", "uefa.champions", "ufc" ], "enumTitles": [ "NFL", "NCAA Football", "NBA", "WNBA", "NCAA Men's Basketball", "NCAA Women's Basketball", "MLB", "NHL", "English Premier League", "Spanish LaLiga", "German Bundesliga", "Italian Serie A", "French Ligue 1", "MLS", "Mexican Liga MX", "UEFA Champions League", "UFC" ] } }, "dataTypes": { "title": "Data", "type": "array", "description": "What to collect. Games and box scores use the date range below; the others return current data.", "items": { "type": "string", "enum": [ "games", "boxScores", "standings", "teams", "rosters", "injuries", "news" ], "enumTitles": [ "Games: scores, status, betting odds, leaders", "Box scores: one row per player per game", "Standings", "Teams", "Rosters (players of every team)", "Injury reports", "News headlines" ] } }, "startDate": { "title": "Start date", "type": "string", "description": "First game day (YYYY-MM-DD). Default: yesterday. Upcoming dates return schedules with odds." }, "endDate": { "title": "End date", "type": "string", "description": "Last game day (YYYY-MM-DD). Default: today. Up to 400 days per run." }, "teams": { "title": "Teams (optional)", "type": "array", "description": "Limit to these teams by abbreviation or full name, e.g. “LAL”, “Boston Celtics”, “ARS”.", "items": { "type": "string" } }, "homeAway": { "title": "Home or away (with Teams)", "enum": [ "any", "home", "away" ], "type": "string", "description": "Used together with Teams: keep only home games or only away games of those teams.", "default": "any" }, "gameStatus": { "title": "Game status", "enum": [ "any", "scheduled", "live", "final" ], "type": "string", "description": "Keep only games in this state. “Live now” gives in-progress scores with period and clock.", "default": "any" }, "startingWithinHours": { "title": "Starting within (hours)", "minimum": 0, "maximum": 336, "type": "integer", "description": "Keep only games that start in the next N hours, e.g. 24 for the next day's schedule. Extends the date range automatically." }, "broadcastNetworks": { "title": "TV networks", "type": "array", "description": "Keep only games broadcast on these networks (partial match), e.g. “ESPN”, “TNT”, “Prime Video”.", "items": { "type": "string" } }, "season": { "title": "Standings season", "type": "integer", "description": "Season year for standings, e.g. 2025. Default: current season." }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many records. You are charged per record.", "default": 1000 }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy works for ESPN.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }