Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the ESPN API page →
docs / espn

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.

base /espn/v113 endpoints
post/espn/v1/scores1 credit

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

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
dateoptional—Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.
Try in playground →
post/espn/v1/fixtures1 credit

Upcoming fixtures and the match schedule for a league, by date or date range (same event shape as scores).

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
dateoptional—Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.
Try in playground →
post/espn/v1/standings1 credit

Full league table / standings with wins, losses, points and per-team stats (soccer leagues accept a season year).

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
seasonoptional—Season year (soccer standings need it; default current season).
Try in playground →
post/espn/v1/team1 credit

Every team in a league, or one team's detail (record, next game, logo) when you pass a team_id.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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_idoptional—ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets).
Try in playground →
post/espn/v1/roster1 credit

A team's full roster / squad with jersey, position, age, height, weight and nationality for each player.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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_idrequired—ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets).
Try in playground →
post/espn/v1/summary2 credits

Full match summary: boxscore, per-player stats, lineups, play-by-play count, head-to-head, win probability and odds.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/espn/v1/odds1 credit

Betting odds (moneyline, spread, over/under) — for one game by event_id, or every scheduled game in the league that has odds.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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_idoptional—Optional ESPN event id: returns the closing line for that one game; omit to list every scheduled game that currently has odds.
dateoptional—Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.
Try in playground →
post/espn/v1/news1 credit

Latest news headlines and articles for a league.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
Try in playground →
post/espn/v1/injuries1 credit

Current injury report for a league, grouped by team, with each player's status and detail.

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
Try in playground →
post/espn/v1/team_schedule1 credit

One team's full season schedule and results (every game the team plays, unlike league-wide fixtures).

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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_idrequired—ESPN team id — get it from the `team` action's teams[].team_id for the same sport/league (e.g. 13 = NBA Denver Nuggets).
seasonoptional—Season year (soccer standings need it; default current season).
Try in playground →
post/espn/v1/conferences1 credit

A league's conference / division structure (the directory of groups and sub-groups, e.g. college conferences).

ParameterAllowed / rangeDescription
sportrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
leaguerequirednba · 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-cupLeague 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.
Try in playground →
post/espn/v1/leagues1 credit

Directory of every supported league/competition (key, name, sport) — call this first to discover the league keys the other actions take.

ParameterAllowed / rangeDescription
sportoptionalbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.