ESPN Sports Data Scraper

Collect ESPN sports data as structured dataset rows for research, dashboards, fantasy workflows, and feeds for AI agents / MCP tools.

What it collects

• Scoreboards: game/event ID, scheduled date, status, teams and scores, venue, odds/spread when supplied, broadcasts, and leaders.
• Standings: league or conference groups, rank when supplied, team record and available stats.
• Teams: team ID, display name, abbreviation, location, logo, and ESPN page.
• Rosters: player rows with team, position, jersey, available bio/status fields, and headshot.
• League news: headline, description, publication time, author and article URL.

Available league IDs: nfl, nba, wnba, mlb, nhl, college-football, mens-college-basketball, mls, premier-league, la-liga, serie-a, bundesliga, ligue-1, champions-league, f1, ufc, tennis-atp, and tennis-wta. ESPN returns empty datasets for some combinations, such as UFC standings or tennis team rosters; those sources can complete successfully with zero rows.

Input

{
  "leagues": ["nba", "premier-league"],
  "dataTypes": ["scoreboard"],
  "dateFrom": "2026-10-09",
  "dateTo": "2026-10-09",
  "maxItemsPerSource": 50
}

The prefilled run selects NBA and Premier League scoreboards for today. If dates are omitted, the actor uses the current UTC date. dateTo can extend the scoreboard query to a date range of up to 63 days. maxItemsPerSource defaults to 500 (prefill 50). Unknown league names produce a free error row.

Output example

Trimmed from a real ESPN scoreboard result:

{
  "type": "game",
  "league": "nba",
  "eventId": "401898395",
  "name": "Houston Rockets at Dallas Mavericks",
  "date": "2026-10-09T12:00Z",
  "status": "Final",
  "homeTeam": { "id": "6", "name": "Dallas Mavericks", "abbreviation": "DAL" },
  "awayTeam": { "id": "10", "name": "Houston Rockets", "abbreviation": "HOU" },
  "homeScore": "117",
  "awayScore": "135",
  "venue": { "name": "Venetian Arena" },
  "broadcasts": [{ "market": "national", "names": ["NBA TV"] }]
}

Each data row is charged as the result event. Summary and error rows are free.

Price: $1.00 per 1,000 results

Notes and FAQ

Are live scores guaranteed? No. ESPN's public JSON endpoints may change, and schedules vary by date. Empty scoreboards are valid when no events are scheduled.

How are rosters collected? The actor fetches the selected league's team list, then requests each team's roster. Roster mode can take longer and emits player rows up to the per-source cap.

Does the actor fetch game summaries? No. ESPN's event summary endpoint is available for some events, but this actor currently returns scoreboard data only and does not make extra summary requests per game.

Do all leagues support every data type? The endpoints respond for the league list above. Some sports do not expose meaningful team rosters or standings through the same ESPN API routes; empty results are possible.

Can I use these rows with an AI agent or MCP server? Yes. Dataset rows are JSON and can be consumed as an agent or MCP data source.