# ESPN Sports Scores, Schedules & Standings Scraper (`mangudai/espn-sports-scores-scraper`) Actor Scrape live scores, schedules, standings, teams and news from ESPN. Covers NFL, NBA, MLB, NHL, WNBA, college football and basketball, and world soccer like the Premier League, LaLiga, Serie A and MLS. No key or login. Pick any date or date range. - **URL**: https://apify.com/mangudai/espn-sports-scores-scraper.md - **Developed by:** [MangudΓ€i](https://apify.com/mangudai) (community) - **Categories:** News, Developer tools, Open source - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.95 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ESPN Sports Scores, Schedules & Standings Scraper Pull live scores, fixtures, league tables, team directories and news from ESPN across the major US and world leagues. The actor reads ESPN's public site API, the same JSON that loads the scoreboards and standings pages on espn.com. No API key, no login, no captcha. Every request runs through Apify Proxy. One run can cover several leagues at once. Ask for today's scores, a specific date, or a whole date range of past and upcoming games. ### What you can pull Pick one data type per run with the `mode` field: - `scoreboard` gives one row per game: teams, live or final score, game state and clock, records, venue, TV, and optional betting odds. - `standings` gives the league table: one row per team with wins, losses, ties, win percent, games behind, points and the full stat line. - `teams` gives the team directory: name, abbreviation, location, colors, logo and the team page link. - `news` gives recent league headlines with the article link, image and publish time. ### Leagues Use these keys in the `leagues` field: - American football: `nfl`, `college-football` - Basketball: `nba`, `wnba`, `ncaam`, `ncaaw` - Baseball: `mlb` - Hockey: `nhl` - Soccer: `epl`, `laliga`, `seriea`, `bundesliga`, `ligue1`, `mls`, `ucl`, `uel` Need a league that is not on the list? Pass the raw ESPN slug, for example `soccer/ned.1` for the Dutch Eredivisie or `soccer/por.1` for the Portuguese Primeira Liga. ### Input | Field | What it does | | --- | --- | | `mode` | scoreboard, standings, teams or news. Default scoreboard. | | `leagues` | List of league keys. Default nfl, nba, mlb, nhl. | | `dates` | Scoreboard only. A single date `2026-09-10` or a range `2026-09-10..2026-09-15`. Empty means today. | | `includeOdds` | Scoreboard only. Adds spread, over/under and moneyline when ESPN has them. | | `maxItemsPerLeague` | Cap the rows per league. 0 means no cap. | | `proxyConfiguration` | Apify Proxy settings. The default works. | ### Example input ```json { "mode": "scoreboard", "leagues": ["nba", "mlb", "epl"], "dates": "2026-09-12", "includeOdds": true } ```` ### Output sample A scoreboard row looks like this: ```json { "league": "mlb", "leagueName": "MLB", "name": "Pittsburgh Pirates at New York Yankees", "date": "2026-07-22T17:05Z", "state": "post", "statusDetail": "Final/10", "homeTeam": "New York Yankees", "homeScore": "3", "homeRecord": "56-45", "awayTeam": "Pittsburgh Pirates", "awayScore": "5", "venue": "Yankee Stadium", "broadcast": "MLB.TV, YES", "eventLink": "https://www.espn.com/mlb/game/_/gameId/401816219/pirates-yankees" } ``` Standings, teams and news each return their own row shape. Every row carries `league`, `leagueName`, `sport` and `scrapedAt` so you can merge datasets from different runs. ### How to use the data Feed live scores into a bot or a dashboard, track a division race with daily standings runs, build a fixtures calendar from a date range, or keep a rolling table of team metadata and logos. Results export to JSON, CSV or Excel, or read them straight from the Apify API. ### Notes on reliability The site API is stable and public, so the scraper leans on it rather than on page HTML that changes often. Off season a league still returns its scheduled games and preseason table, so a run is rarely empty. Scores update as games play, so run scoreboard mode on a schedule if you want live data. # Actor input Schema ## `mode` (type: `string`): What to pull for each league. Scoreboard returns one row per game with live score, status and schedule. Standings returns the league table. Teams returns the team directory. News returns recent headlines. ## `leagues` (type: `array`): One or more league keys. Supported: nfl, college-football, nba, wnba, ncaam, ncaaw, mlb, nhl, and soccer keys epl, laliga, seriea, bundesliga, ligue1, mls, ucl, uel. You can also pass a raw ESPN slug like soccer/ned.1. ## `dates` (type: `string`): Scoreboard only. A single date like 2026-09-10, or a range like 2026-09-10..2026-09-15. Leave empty for today's games. ## `includeOdds` (type: `boolean`): Scoreboard only. Adds spread, over/under and moneyline fields when ESPN provides them for a game. ## `maxItemsPerLeague` (type: `integer`): Cap the rows returned per league. Use 0 for no cap. ## `proxyConfiguration` (type: `object`): Requests run through Apify Proxy. The default datacenter setting works for ESPN. ## Actor input object example ```json { "mode": "scoreboard", "leagues": [ "nfl", "nba", "mlb", "nhl" ], "includeOdds": false, "maxItemsPerLeague": 0, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `datasetItems` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "leagues": [ "nfl", "nba", "mlb", "nhl" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("mangudai/espn-sports-scores-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "leagues": [ "nfl", "nba", "mlb", "nhl", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("mangudai/espn-sports-scores-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "leagues": [ "nfl", "nba", "mlb", "nhl" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call mangudai/espn-sports-scores-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mangudai/espn-sports-scores-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ESPN Sports Scores, Schedules & Standings Scraper", "description": "Scrape live scores, schedules, standings, teams and news from ESPN. Covers NFL, NBA, MLB, NHL, WNBA, college football and basketball, and world soccer like the Premier League, LaLiga, Serie A and MLS. No key or login. Pick any date or date range.", "version": "0.0", "x-build-id": "ywnC1A9nDLXyO0tmY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mangudai~espn-sports-scores-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mangudai-espn-sports-scores-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/mangudai~espn-sports-scores-scraper/runs": { "post": { "operationId": "runs-sync-mangudai-espn-sports-scores-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/mangudai~espn-sports-scores-scraper/run-sync": { "post": { "operationId": "run-sync-mangudai-espn-sports-scores-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": "Data type", "enum": [ "scoreboard", "standings", "teams", "news" ], "type": "string", "description": "What to pull for each league. Scoreboard returns one row per game with live score, status and schedule. Standings returns the league table. Teams returns the team directory. News returns recent headlines.", "default": "scoreboard" }, "leagues": { "title": "Leagues", "type": "array", "description": "One or more league keys. Supported: nfl, college-football, nba, wnba, ncaam, ncaaw, mlb, nhl, and soccer keys epl, laliga, seriea, bundesliga, ligue1, mls, ucl, uel. You can also pass a raw ESPN slug like soccer/ned.1.", "default": [ "nfl", "nba", "mlb", "nhl" ], "items": { "type": "string" } }, "dates": { "title": "Date or date range", "type": "string", "description": "Scoreboard only. A single date like 2026-09-10, or a range like 2026-09-10..2026-09-15. Leave empty for today's games." }, "includeOdds": { "title": "Include betting odds", "type": "boolean", "description": "Scoreboard only. Adds spread, over/under and moneyline fields when ESPN provides them for a game.", "default": false }, "maxItemsPerLeague": { "title": "Max items per league", "minimum": 0, "type": "integer", "description": "Cap the rows returned per league. Use 0 for no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests run through Apify Proxy. The default datacenter setting 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 } } }, "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 } } } } } } } } } } ```