{ "openapi": "3.0.1", "info": { "title": "ESPN Sports Data Scraper – Scores, Schedules, Standings & Odds", "description": "Extract ESPN sports data: live scores, schedules, standings, teams and box scores for NFL, NBA, MLB, NHL, college sports, top soccer leagues and UFC. Clean JSON for bettors, odds modellers, fantasy apps and AI agents.", "version": "0.1", "x-build-id": "UdXxBLQCs9gCoE1ek" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rowfeed~espn-sports-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rowfeed-espn-sports-data-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/rowfeed~espn-sports-data-scraper/runs": { "post": { "operationId": "runs-sync-rowfeed-espn-sports-data-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/rowfeed~espn-sports-data-scraper/run-sync": { "post": { "operationId": "run-sync-rowfeed-espn-sports-data-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": { "leagues": { "title": "Leagues", "type": "array", "description": "Leagues to scrape. Supported: nfl, college-football, nba, wnba, mens-college-basketball, mlb, nhl, eng.1 (Premier League), esp.1 (La Liga), ger.1 (Bundesliga), ita.1 (Serie A), fra.1 (Ligue 1), usa.1 (MLS), uefa.champions, ufc.", "default": [ "nfl", "nba", "mlb", "nhl" ], "items": { "type": "string" } }, "dataType": { "title": "Data type", "enum": [ "scoreboard", "schedule", "standings", "teams", "summary" ], "type": "string", "description": "scoreboard/schedule return games for the date range below. standings returns the league table. teams returns the team list. summary returns a box score for each event ID.", "default": "scoreboard" }, "dateFrom": { "title": "Date from", "type": "string", "description": "Start date as YYYY-MM-DD. Empty = today (UTC). Used by scoreboard and schedule.", "default": "" }, "dateTo": { "title": "Date to", "type": "string", "description": "End date as YYYY-MM-DD. Empty = same as \"Date from\". Ranges are capped at 31 days.", "default": "" }, "eventIds": { "title": "Event IDs", "type": "array", "description": "ESPN event IDs to summarize, e.g. from a scoreboard row's event_id. Only used when dataType is summary.", "default": [], "items": { "type": "string" } }, "maxEvents": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Keep at most this many rows (games, standings, teams or summaries). Each row is one charged event.", "default": 200 }, "includeOdds": { "title": "Include odds", "type": "boolean", "description": "Include odds/spread/over-under/moneyline fields from the scoreboard when a sportsbook has posted a line.", "default": 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 } } }, "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 } } } } } } } } } }