ESPN
ESPN scores, fixtures, standings, rosters, match summaries, odds, injuries and news for the NFL, NBA, MLB, NHL, college sports, cricket and soccer, as JSON.
/espn/v1/scores1 creditLive and final scores for a league — pass a date (YYYYMMDD) or range to get scores for any day; omit it for today/in-play games.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| date | optional | — | Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live. |
/espn/v1/fixtures1 creditUpcoming fixtures and the match schedule for a league, by date or date range (same event shape as scores).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| date | optional | — | Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live. |
/espn/v1/standings1 creditFull league table / standings with wins, losses, points and per-team stats (soccer leagues accept a season year).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
/espn/v1/team1 creditEvery team in a league, or one team's detail (record, next game, logo) when you pass a team_id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| team_id | optional | — | ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets). |
/espn/v1/roster1 creditA team's full roster / squad with jersey, position, age, height, weight and nationality for each player.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| team_id | required | — | ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets). |
/espn/v1/summary2 creditsFull match summary: boxscore, per-player stats, lineups, play-by-play count, head-to-head, win probability and odds.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/espn/v1/odds1 creditBetting odds (moneyline, spread, over/under) — for one game by event_id, or every scheduled game in the league that has odds.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| event_id | optional | — | Optional ESPN event id: returns the closing line for that one game; omit to list every scheduled game that currently has odds. |
| date | optional | — | Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live. |
/espn/v1/news1 creditLatest news headlines and articles for a league.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
/espn/v1/search1 creditLook up a team or player by name across all sports (returns ids, badges, league, country) — start here when you only have a name.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text for a team/player/tournament/manager/referee. |
| type = team | optional | team · player | What to look up in the (thesportsdb) search. Defaults to team. |
/espn/v1/injuries1 creditCurrent injury report for a league, grouped by team, with each player's status and detail.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
/espn/v1/team_schedule1 creditOne team's full season schedule and results (every game the team plays, unlike league-wide fixtures).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
| team_id | required | — | ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets). |
| season | optional | — | Season year (soccer standings need it; default current season). |
/espn/v1/conferences1 creditA league's conference / division structure (the directory of groups and sub-groups, e.g. college conferences).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| league | required | nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup | League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id. |
/espn/v1/leagues1 creditDirectory of every supported league/competition (key, name, sport) — call this first to discover the league keys the other actions take.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | optional | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
curl -X POST https://api.reefapi.com/espn/v1/scores \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"sport":"soccer","league":"eng.1","dates":"20260301-20260331"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.