# ESPN Sports Scores and Injury Reports Scraper (`cleanscrape/espn-sports-scores-injury-reports`) Actor

Sports scores, schedules and results from ESPN for the NFL, NBA, MLB, NHL, WNBA, college sports and top soccer leagues, plus the NFL, NBA, MLB, NHL and WNBA injury reports with status, injury and expected return. Only new or changed injuries on a schedule. No API key. $1 per 1,000 games.

- **URL**: https://apify.com/cleanscrape/espn-sports-scores-injury-reports.md
- **Developed by:** [CleanScrape](https://apify.com/cleanscrape) (community)
- **Categories:** Automation, Developer tools, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 games

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ESPN Sports Scores and Injury Reports Scraper

Get sports scores, schedules and results from ESPN, and the current injury reports, as clean tables. Choose leagues and days: each game comes with teams, score, status, records, score by period, venue, TV and the betting line ESPN shows. The injury report lists every injured player with status (Out, Questionable, Injured Reserve...), injury, expected return date and the latest news note. No API key or login.

Leagues: NFL, college football (FBS), NBA, WNBA, men's and women's college basketball, MLB, NHL, Premier League, LaLiga, Bundesliga, Serie A, Ligue 1, Champions League, Europa League, MLS, NWSL and Liga MX. Injury reports: NFL, NBA, MLB, NHL and WNBA.

**Price:** $1 per 1,000 games and $0.30 per 1,000 injury entries. No start fee. Days without games cost nothing.

### Watch the walkthrough

Monday night's Chargers-Ravens game, tonight's NBA betting lines, the whole 2025 NFL season (286 games in 22 seconds) and the injury report. This 95-second demo uses real runs and ends with a scheduled watch that returns only the injuries that changed.

https://youtu.be/vOM8b9749Pg

### Start with a small run

1. The form opens with the **NBA**. Keep it or choose your leagues.
2. **What to collect**: games and the injury report, or only one of them.
3. **From date** is today. Type another date, or yesterday, "-7 days", "+3 days". Set **To date** for a range.
4. Click **Start**. Open **Games** and **Injury report** in the Output tab. Export CSV, Excel or JSON.

### Choose a ready-to-run example

Each example opens with its input filled in. Change the leagues or dates and run it.

| Example | What it does |
| --- | --- |
| [Today's NBA games with the injury report](https://apify.com/cleanscrape/espn-sports-scores-injury-reports/examples/nba-games-today-with-injury-report) | Tonight's games with TV and betting lines, plus every player on the NBA injury report. About $0.04. |
| [NFL scores and results from the last 7 days](https://apify.com/cleanscrape/espn-sports-scores-injury-reports/examples/nfl-scores-last-7-days) | Every NFL game of the past week with final score, winner and score by quarter. About $0.02. |
| [Premier League results this season](https://apify.com/cleanscrape/espn-sports-scores-injury-reports/examples/premier-league-results-this-season) | Every Premier League result since August with score, winner or draw, and attendance. About $0.10. |

### Get only new or changed injuries

Turn on **Only new or changed injuries** and schedule the run, for example every hour on game days:

- The first run returns the whole report as the starting point.
- Each later run returns only entries that are new, changed (status, expected return, injury or news note) or no longer listed. `change` says which, and `previousStatus` shows the status before.
- Runs with the same leagues and filters share one history, kept in your own Apify account. Give a **Watch name** to keep the history when you change the filters.

A player who moves from Questionable to Out comes back as `updated` with `previousStatus` Questionable. A player who leaves the report comes back once as `removed`. Each league report compared costs $0.0003 (the same as one entry), also when nothing changed.

### Use it from the API

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("cleanscrape/espn-sports-scores-injury-reports").call(run_input={
    "leagues": ["nfl", "nba"],
    "collect": "both",
    "startDate": "yesterday",
    "endDate": "today",
    "gameStatus": "final",
})
for game in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(game["shortName"], game["awayScore"], game["homeScore"], game["statusDetail"])
injuries = client.dataset(run["storageIds"]["datasets"]["injuries"])
for row in injuries.iterate_items():
    print(row["team"], row["player"], row["status"], row["injury"], row["expectedReturn"])
```

### Input

| Field | Default | What it does |
| --- | --- | --- |
| `leagues` | Required | League keys: `nfl`, `college-football`, `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball`, `mlb`, `nhl`, `premier-league`, `la-liga`, `bundesliga`, `serie-a`, `ligue-1`, `champions-league`, `europa-league`, `mls`, `nwsl`, `liga-mx` |
| `collect` | `both` | `both`, `scores` or `injuries` |
| `startDate` | `today` | First day of games: `2026-11-15`, `today`, `yesterday`, `tomorrow`, `-7 days`, `+3 days` |
| `endDate` | Same day | Last day of games. Up to 366 days per run |
| `teams` | All | Team names, cities or abbreviations: `Lakers`, `Kansas City`, `BOS`, `Arsenal` |
| `gameStatus` | `all` | `all`, `scheduled`, `live` or `final` |
| `injuryStatuses` | All | Statuses to keep: `Out`, `Doubtful`, `Questionable`, `Day-To-Day`, `IR`, `IL` |
| `includeActive` | `false` | Also keep NFL players listed as Active (cleared to play) |
| `onlyChangedInjuries` | `false` | Only injuries that are new, changed or removed since the last run |
| `watchName` | None | A name for that history |

Days are ESPN's calendar days, in US Eastern time: a 10 PM game in Los Angeles is on that day, not the next.

### Output

**Games** (default dataset), one row per game:

| Field | What it is |
| --- | --- |
| `recordId`, `eventId` | `league:eventId`, stable across runs, and ESPN's game ID |
| `league`, `leagueName`, `sport` | The league |
| `date`, `season`, `seasonType`, `week` | Start time in UTC, ESPN's season year, season type and week |
| `name`, `shortName` | "Indiana Pacers at Philadelphia 76ers", "IND @ PHI" |
| `status`, `statusDetail`, `period`, `clock` | `scheduled`, `live`, `final`, `postponed`, `canceled` or `delayed`, and ESPN's own wording |
| `homeTeam`, `homeTeamAbbreviation`, `homeTeamId`, `homeScore`, `homeRecord` | Home side (scores empty before the game) |
| `awayTeam`, `awayTeamAbbreviation`, `awayTeamId`, `awayScore`, `awayRecord` | Away side |
| `winner` | Winning team, or `Draw`, once final |
| `homeScoreByPeriod`, `awayScoreByPeriod` | Points per quarter, half, inning or period |
| `venue`, `venueCity`, `venueState`, `venueCountry`, `neutralSite`, `attendance` | Where it is played |
| `broadcasts` | TV and streaming ESPN lists |
| `oddsProvider`, `oddsLine`, `overUnder` | The line ESPN shows, usually before the game |
| `notes`, `gameUrl`, `fetchedAt` | Playoff round and similar, the ESPN game page, when it was read |

**Injury report** (dataset `injuries`), one row per player entry:

| Field | What it is |
| --- | --- |
| `recordId` | `league:ESPN entry ID` |
| `league`, `leagueName`, `team`, `teamAbbreviation`, `teamId` | League and team |
| `player`, `playerId`, `position`, `playerUrl` | The player |
| `status`, `statusAbbreviation`, `fantasyStatus` | Out, Doubtful, Questionable, Day-To-Day, Injured Reserve, 10-Day IL and so on |
| `injury`, `bodyPart`, `side`, `detail` | Such as Knee, Leg, Left, Sprain, when ESPN gives them |
| `expectedReturn` | ESPN's estimated return date, when given |
| `shortComment`, `longComment`, `reportedAt` | The latest news note, the longer analysis, and when ESPN updated the entry |
| `change`, `previousStatus` | With **Only new or changed injuries**: `new`, `updated` or `removed`, and the status before |

The run report (`SUMMARY` in the key-value store) lists each league with the days read, games found and saved, and the injury entries read and saved.

### What it can and cannot do

- Scores are ESPN's. Live games show the score at the moment of the run; run it again, or on a schedule, for updates.
- ESPN publishes injury reports for the NFL, NBA, MLB, NHL and WNBA only. Soccer and college leagues have games but no injury report.
- The injury report is ESPN's current list. It has no history of past dates; use **Only new or changed injuries** on a schedule to keep your own.
- Expected return dates are ESPN's estimates and are often empty.
- Betting lines appear only when ESPN shows them, usually before the game.
- College scoreboards cover FBS football and Division I basketball.
- Player statistics, box scores, play-by-play and standings are not included.

### Pricing

| Event | Price |
| --- | --- |
| Game saved | $0.001 ($1 per 1,000) |
| Injury report entry saved | $0.0003 ($0.30 per 1,000) |
| Injury report check, only with **Only new or changed injuries** | $0.0003 per league per run |

Apify platform usage is included. Paid Apify plans get a discount (Bronze 10%, Silver 15%, Gold and higher 20%).

Examples:

- Today's NBA games with the NBA injury report: about 10 games and 100 injuries, $0.04.
- A full NFL regular season of results (18 weeks, about 270 games): $0.27.
- The NFL injury report without Active players: about 190 entries, $0.06.
- An hourly injury watch for four leagues: $0.03 a day for the checks, plus $0.0003 per new or changed entry.

Not charged: days without games, games or injuries removed by your filters, unchanged injuries in watch mode (only the check), and input that cannot run. The run stops at the **Maximum cost per run** you set and says so.

### Common questions

#### Is there an official ESPN API?

ESPN has no public, documented API for this. The Actor reads the public data ESPN's own website and apps use, and turns it into flat rows.

#### How far back can it go?

Scoreboards go back many seasons. One run reads up to 366 days; run it again for earlier years. The injury report is always the current one.

#### Can I get live scores?

Yes, as of the moment of the run. For a scoreboard that updates during games, schedule the run every few minutes with **Games to keep** set to In progress, or call it from your code.

#### Can I export to Excel or CSV?

Yes. Open the Output tab and choose Export, or fetch the datasets through the API in CSV, Excel, JSON or XML. The Export button exports games; the injury report is under Storage, dataset `injuries`.

#### Do I need an API key or an ESPN account?

No.

#### Is it legal to collect this data?

The Actor reads public scores and injury news that ESPN shows to every visitor. You are responsible for how you use the data and for following the terms that apply to you.

### Support

Questions or a result that looks wrong: open an issue on the Issues tab or email contact.cleanscrape@gmail.com. Include the run ID.

If the Actor was useful, an honest review on its Store page helps other people find it.

This Actor is not affiliated with, endorsed by or sponsored by ESPN, the NFL, NBA, MLB, NHL, WNBA, NCAA or any league or team.

Maintained by CleanScrape.

### More tools from CleanScrape

- [App Store Reviews & Google Play Reviews Scraper (Play Store)](https://apify.com/cleanscrape/app-store-reviews-scraper): App Store and Google Play reviews with ratings, dates, app versions and developer replies, for one app or many
- [Google Trends Scraper API for Interest Over Time](https://apify.com/cleanscrape/google-trends-scraper): search interest over time, by region, related queries and trending searches
- [Map Your Show Exhibitor List Scraper for Trade Shows](https://apify.com/cleanscrape/event-exhibitor-monitor): trade show exhibitor lists and booth changes
- [Shopify Product Reviews Scraper for Judge.me and Okendo](https://apify.com/cleanscrape/shopify-reviews-scraper): Judge.me and Okendo reviews from Shopify product links
- [Google News Scraper and RSS Feed Reader](https://apify.com/cleanscrape/google-news-scraper): headlines from Google News and publisher feeds
- [Pinterest Scraper API for Pins and Pinterest Keyword Search](https://apify.com/cleanscrape/pinterest-scraper): keyword search, public pin links and board previews; search results may lack a pin link
- [Google Hotels Scraper for Google Travel Hotel Prices](https://apify.com/cleanscrape/google-hotels-scraper): hotel prices and booking offers for your dates
- [TikTok Shop Scraper API for Products, Prices and Sales](https://apify.com/cleanscrape/tiktok-shop-product-scraper): US TikTok Shop prices, sellers and ratings
- [Meta Threads Scraper for Posts and Replies](https://apify.com/cleanscrape/threads-scraper): public Threads posts from accounts or post links
- [Likee Scraper API](https://apify.com/cleanscrape/likee-scraper): Likee videos and comments
- [Flashscore Tennis Scraper for Tennis Matches and Stats](https://apify.com/cleanscrape/tennis-match-data): tennis results, statistics, point-by-point and head-to-head
- [Bilibili Scraper for Videos, Comments, Danmaku, Creators](https://apify.com/cleanscrape/bilibili-scraper): Bilibili videos, danmaku, top comments and creators, no login
- [Google Jobs Scraper for Job Search and Job Listings API](https://apify.com/cleanscrape/google-jobs-scraper): job listings with salaries, descriptions and apply links from Google Jobs
- [Whatnot Seller Tracker for Top Sellers and Sales](https://apify.com/cleanscrape/whatnot-seller-tracker): top Whatnot sellers per category, items sold, sales per day and followers over time
- [Whatnot Scraper for Listings and Live Shows](https://apify.com/cleanscrape/whatnot-scraper): Whatnot listings with prices and live shows by keyword or category
- [Kick Sponsor Tracker for Streamers, Brands and Promo Codes](https://apify.com/cleanscrape/kick-sponsor-tracker): which brands Kick streamers promote, with promo codes, affiliate links and broadcast hours
- [Casino Bonus Checker for Affiliate and Review Sites](https://apify.com/cleanscrape/casino-bonus-checker): the casino bonus each affiliate and review site shows, with promo codes, 18+ notices and affiliate IDs
- [ATP and WTA Tennis Rankings Scraper](https://apify.com/cleanscrape/tennis-rankings-scraper): current ATP and WTA singles, doubles and race rankings with points and movement
- [Career Site Job Listings from Workday, Greenhouse and Lever](https://apify.com/cleanscrape/career-site-jobs-scraper): open jobs from company career pages, with salaries and new or closed jobs per company
- [Video Frame Extractor for Scene Changes and Thumbnails](https://apify.com/cleanscrape/video-frame-extractor): still images from video files at scene changes, intervals or timestamps, with contact sheets
- [Economic Calendar Scraper for Official Release Dates](https://apify.com/cleanscrape/economic-calendar-api): CPI, jobs, GDP and central bank decision dates from the official agencies of five economies, with UTC times
- [Audio Transcription and Speech to Text for Podcasts](https://apify.com/cleanscrape/podcast-transcription): podcast feeds, Apple Podcasts links and audio files to text with timestamps and subtitles
- [Google Flights Scraper and Fare Tracker](https://apify.com/cleanscrape/google-flights-scraper): flight prices, airlines, stops and times for your routes and dates, with only new flights or lower prices on a schedule
- [Google Shopping Scraper and Price Tracker](https://apify.com/cleanscrape/google-shopping-scraper): product prices, stores and ratings from Google Shopping, each store’s price for a product, and price changes on a schedule
- [Telegram Channel Messages Scraper with Comments](https://apify.com/cleanscrape/telegram-channel-messages-scraper): public Telegram channel posts with views, reactions, media and comments, exact subscriber counts, and only new posts on a schedule
- [Google Trends Trending Now Scraper for Trending Searches](https://apify.com/cleanscrape/google-trends-trending-now): every search trending on Google now by country, with volume, growth, start time and related searches
- [Telegram Channel Search and Telegram Group Search Scraper](https://apify.com/cleanscrape/telegram-channel-search-scraper): find public Telegram channels and groups by topic, with exact subscribers and latest post date
- [App Store Search and Google Play Search Scraper](https://apify.com/cleanscrape/app-store-google-play-search-scraper): apps for a keyword in the App Store and Google Play, in store order, with ratings, installs and developer contact
- [Audio & Video Transcription (Whisper) for Text and Subtitles](https://apify.com/cleanscrape/audio-video-transcription-whisper): audio and video files to text with timestamps and SRT and VTT subtitles, with Whisper
- [Steam Reviews Scraper for Steam Game Reviews and Store Data](https://apify.com/cleanscrape/steam-reviews-scraper): Steam game reviews with playtime, votes, language and Steam Deck details, filtered by date or language, plus each game's review score and store data
- [Google People Also Ask Scraper with Related Searches](https://apify.com/cleanscrape/google-people-also-ask-scraper): Google People Also Ask questions with Google's AI Overview answer and top result for each, plus related searches, for any keyword and country
- [Bulk File Downloader for Images, PDFs, Video and Audio](https://apify.com/cleanscrape/bulk-file-downloader): images, PDFs, videos and audio from a list of links or from any scraper's results, with download links, sizes, SHA-256 and optional ZIP archives

# Actor input Schema

## `leagues` (type: `array`):

One or more leagues. In the API use the keys: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, premier-league, la-liga, bundesliga, serie-a, ligue-1, champions-league, europa-league, mls, nwsl, liga-mx.

## `collect` (type: `string`):

Games come from the scoreboard of each day you choose. The injury report is ESPN's current list for the NFL, NBA, MLB, NHL and WNBA; it has no dates.

## `startDate` (type: `string`):

The first day of games: a date such as 2026-11-15, or today, yesterday, tomorrow, "-7 days" or "+3 days". Days are ESPN's, in US Eastern time.

## `endDate` (type: `string`):

The last day of games, in the same forms. Leave empty for one day. Up to 366 days per run.

## `teams` (type: `array`):

Keep only these teams, by name, city or abbreviation: Lakers, Kansas City, BOS, Arsenal. Applies to games and injuries.

## `gameStatus` (type: `string`):

Final keeps finished games; scheduled keeps games not started yet.

## `injuryStatuses` (type: `array`):

Keep only these statuses, such as Out, Doubtful, Questionable, Day-To-Day, Injured Reserve (or IR) and IL (every MLB injured list). Leave empty for all.

## `includeActive` (type: `boolean`):

The NFL report also lists players who are cleared to play (status Active), often hundreds. They are left out unless you turn this on.

## `onlyChangedInjuries` (type: `boolean`):

Return only injuries that are new, changed (status, return date, injury or note) or no longer listed since the last run with the same leagues and filters. For scheduled runs. The first run returns the whole report.

## `watchName` (type: `string`):

Give the history its own name, so you can change the filters and keep it, or run two separate watches. The history is kept in your own Apify account.

## Actor input object example

```json
{
  "leagues": [
    "nba"
  ],
  "collect": "both",
  "startDate": "today",
  "gameStatus": "all",
  "includeActive": false,
  "onlyChangedInjuries": false
}
```

# Actor output Schema

## `games` (type: `string`):

No description

## `injuries` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "leagues": [
        "nba"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("cleanscrape/espn-sports-scores-injury-reports").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "leagues": ["nba"] }

# Run the Actor and wait for it to finish
run = client.actor("cleanscrape/espn-sports-scores-injury-reports").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "nba"
  ]
}' |
apify call cleanscrape/espn-sports-scores-injury-reports --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cleanscrape/espn-sports-scores-injury-reports"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9V5yIe2m1MZH9ycDr/builds/S5CwUsbQbMqiRfuxj/openapi.json
