🏈 ESPN Sports Scraper

Live scores, standings and box scores across 8 leagues — 40 data points per game, in seconds. No login, no account, no API key.

ESPN covers more sports than any other single source. This actor turns any of it into clean JSON or CSV: pick your leagues, choose what you want (today's scoreboard, the standings table, the full team list, or a deep box score), and get back scores quarter by quarter, top performers by name, team shooting stats and the game recap — not just the final score.

⚡ Fast	Plain requests, no browser. A full league scoreboard lands in seconds.
🏆 8 leagues	NFL, NBA, MLB, NHL, college football & basketball, Premier League, LaLiga — or any ESPN league path.
📊 Deep	Period-by-period scores, game leaders with player names, team box-score totals, split records.
📅 Any date	Pull today's slate or any past date — season archives included.
✅ Honest nulls	A field comes back null when that sport genuinely doesn't track it — never guessed or filled in.
🔓 No credentials	Nothing to sign up for. Pick a league and run.

---

What data does it extract?

🏀 Games (scoreboard)

Identity & timing: eventId, name, shortName, date, statusState, statusDetail, period, clock, seasonYear, seasonType

Score & result: homeTeam, awayTeam, homeScore, awayScore, homeWinner, awayWinner, homeRecord, awayRecord

Period detail: homePeriodScores, awayPeriodScores — the score of every quarter, inning or period, in order

Top performers: homeLeaders, awayLeaders — the leading scorer, rebounder and playmaker of that game, with player name, ID and position

Team box score: homeTeamStats, awayTeamStats — rebounds, assists, field goals attempted/made, shooting percentages

Context: venue, attendance, broadcast, odds, neutralSite, conferenceGame, eventNote, playByPlayAvailable, gameUrl

Recap: recap, recapHeadline — ESPN's own written summary of the finished game

📋 Standings

Record: wins, losses, ties, winPercent, overallRecord

Split records: homeRecord, roadRecord, lastTenGames, vsConference, vsDivision — how a team performs at home, on the road, and against its own conference

Scoring: pointsFor, pointsAgainst, pointDifferential, avgPointsFor, avgPointsAgainst

Race context: gamesBehind, gamesAhead, playoffSeed, streak, clincher, leagueWinPercent, divisionWinPercent

🛡 Teams

name, teamNameOnly, nickname, shortName, abbreviation, location, slug, color, alternateColor, logo, venue, isActive, isAllStar, teamUrl

📈 Game summary (box score)

Full team statistics, win-probability curve, play-by-play availability, betting lines and pick center, injury report, officials and venue detail.

---

Available leagues

Use a shortcut, or any ESPN league path for everything else.

Shortcut	League
nfl	NFL — National Football League
nba	NBA — National Basketball Association
mlb	MLB — Major League Baseball
nhl	NHL — National Hockey League
ncaaf	NCAA College Football
ncaab	NCAA Men's College Basketball
epl	English Premier League
laliga	Spanish LaLiga

Any other ESPN league works by path — soccer/ger.1 (Bundesliga), soccer/ita.1 (Serie A), soccer/uefa.champions, and so on.

---

Who uses this, and for what

Who	What they run it for
🎯 Betting & odds analysts	Pull lines, win probability and split records alongside results
🏆 Fantasy sports tools	Track player leaders and team form for roster decisions
📰 Sports media & newsletters	Auto-generate scoreboards, standings tables and recaps
📊 Sports data scientists	Build historical datasets by date, with period-level detail
🤖 Bot & app builders	Power score widgets, Discord bots and live alerts
🎓 Students & educators	Free sports datasets without paying for a stats API

---

Quick start — copy an input and run

Today's NFL scoreboard (fastest, good first run)

{ "leagues": ["nfl"], "modes": ["scoreboard"] }

NBA standings with home/road splits

{ "leagues": ["nba"], "modes": ["standings"] }

A specific date in the past

{ "leagues": ["nba"], "modes": ["scoreboard"], "date": "2026-01-15" }

Multiple leagues at once

{ "leagues": ["nfl", "nba", "nhl"], "modes": ["scoreboard", "standings"] }

Full team directory with logos and colors

{ "leagues": ["mlb"], "modes": ["teams"] }

Deep box score for one game (get eventId from a scoreboard run first)

{ "leagues": ["nba"], "modes": ["gameSummary"], "eventIds": ["401810433"] }

---

How to use

1. Add one or more leagues — a shortcut above, or any ESPN league path.
2. Choose your modes: scoreboard, standings, teams, gameSummary.
3. For scoreboard, optionally set a date (YYYY-MM-DD). Defaults to today.
4. For gameSummary, pass the event IDs you want — run scoreboard first to get them.

---

Output example

{
  "recordType": "game",
  "league": "basketball/nba",
  "eventId": "401810433",
  "shortName": "MEM VS ORL",
  "date": "2026-01-15T17:00Z",
  "statusDetail": "Final",
  "homeTeam": "Orlando Magic",
  "homeScore": 118,
  "awayTeam": "Memphis Grizzlies",
  "awayScore": 111,
  "homePeriodScores": [23, 35, 26, 34],
  "awayPeriodScores": [28, 26, 30, 27],
  "homeLeaders": {
    "points":   { "athlete": "Paolo Banchero", "position": "F", "value": "26" },
    "rebounds": { "athlete": "Paolo Banchero", "position": "F", "value": "13" },
    "assists":  { "athlete": "Anthony Black",  "position": "G", "value": "7"  }
  },
  "homeTeamStats": { "rebounds": "54", "assists": "28", "fieldGoalsMade": "41" },
  "venue": "Uber Arena",
  "neutralSite": true,
  "eventNote": "NBA Berlin Game 2026",
  "recap": "Paolo Banchero had 26 points and 13 rebounds...",
  "gameUrl": "https://www.espn.com/nba/game/_/gameId/401810433"
}

---

Performance & cost

Run	Typical time
One league scoreboard	a few seconds
One league standings	a few seconds
Three leagues, scoreboard + standings	under a minute

Runs on lightweight requests with no browser, which keeps it fast and cheap.

Pricing

Pay per result — you are charged per record returned, and nothing else. A scoreboard run in the off-season returns few records and costs accordingly. See the price on the actor page.

FAQ

Why did I get 0 games back? Most likely that league had no games on that date — leagues have off-seasons and rest days. Try standings or teams, which work year-round, or pass a date during the season.

Can I get historical seasons? Yes. Pass any past date to scoreboard and you get that day's completed games, with final scores, period breakdown and recap.

Do I need an ESPN account or key? No. The actor reads ESPN's public data — nothing to sign up for.

Why is a field null? Because that sport genuinely doesn't publish it. Soccer standings have no home/road split the way NBA does, and odds only exist for games ESPN carries lines for. Nothing is guessed or padded.

Keywords

espn scraper, sports data api, live scores scraper, sports standings scraper, box score scraper, nfl scraper, nba scraper, mlb scraper, nhl scraper, sports betting data, fantasy sports data, play by play data, soccer results scraper

Related actors

• TradingView Screener
• Eventbrite Events Scraper
• Reddit Thread Scraper
• Threads Scraper

Disclaimer

This actor collects only publicly available sports data. It does not constitute betting or financial advice. Use the data in compliance with the applicable terms and regulations in your jurisdiction.

Changelog

Version	Date	Changes
1.1	2026-08-18	Added period-by-period scores, game leaders with player names, team box-score totals, game recaps, and split records (home/road/last-10/vs-conference) in standings. Fixed a source-side block that could return empty results.
1.0	2026-07-13	Initial release — scoreboard, standings, teams and box score modes across major leagues