ESPN scores, standings, rosters, odds and injuries for the NFL, NBA, MLB, NHL and soccer, as JSON
- endpoints
- 13
- credits per call
- 1–2
The ESPN API returns ESPN's live and final scores, fixtures, standings, teams, rosters, match summaries, betting odds, injury reports and news as JSON: for the NFL, NBA, WNBA, MLB, NHL, NCAA football, basketball and baseball, ATP and WTA tennis, cricket (IPL, Big Bash, Sheffield Shield, County Championship, Cricket World Cup) and soccer (Premier League, EFL Championship, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, MLS, Liga MX, Brazilian Serie A, Champions League, Europa League, World Cup).
/espn/v1
- POST/espn/v1/scores1 credit
- POST/espn/v1/fixtures1 credit
- POST/espn/v1/standings1 credit
- POST/espn/v1/team1 credit
- POST/espn/v1/roster1 credit
- POST/espn/v1/summary2 credits
- POST/espn/v1/odds1 credit
- POST/espn/v1/news1 credit
- POST/espn/v1/search1 credit
- POST/espn/v1/injuries1 credit
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
ESPN API
4 of 13 endpoints, ready to run
Every match of a league on one day: state, clock, score, venue, broadcasters and team stats
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What ESPN endpoints does ReefAPI ship?
13 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
scores
1 crLive and final scores for a league.
- required
- sport, league
- optional
- date, dates
fixtures
1 crUpcoming fixtures and the match schedule for a league, by date or date range (same event shap…
- required
- sport, league
- optional
- date, dates
standings
1 crFull league table / standings with wins, losses, points and per-team stats (soccer leagues ac…
- required
- sport, league
- optional
- season
team
1 crEvery team in a league, or one team's detail (record, next game, logo) when you pass a team_id.
- required
- sport, league
- optional
- team_id
roster
1 crA team's full roster / squad with jersey, position, age, height, weight and nationality for e…
- required
- sport, league, team_id
- optional
- —
summary
2 crFull match summary.
- required
- sport, league, event_id
- optional
- —
odds
1 crBetting odds (moneyline, spread, over/under).
- required
- sport, league
- optional
- event_id, dates
news
1 crLatest news headlines and articles for a league.
- required
- sport, league
- optional
- —
search
1 crLook up a team or player by name across all sports (returns ids, badges, league, country).
- required
- query
- optional
- type
injuries
1 crCurrent injury report for a league, grouped by team, with each player's status and detail.
- required
- sport, league
- optional
- —
team_schedule
1 crOne team's full season schedule and results (every game the team plays, unlike league-wide fi…
- required
- sport, league, team_id
- optional
- season
conferences
1 crA league's conference / division structure (the directory of groups and sub-groups, e.g.
- required
- sport, league
- optional
- —
leagues
1 crDirectory of every supported league/competition (key, name, sport).
- required
- —
- optional
- sport
Every parameter, every allowed value →
Missing a ESPN endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the ESPN API works
ESPN is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a league key to a full match card and the table
Pick the league, read the day's matches, open one match in full, then add the table for context.
{"sport": "soccer"}The league keys the other actions take, with their names. The directory lists 30 keys across 7 sports and also accepts any other ESPN league code with its sport (bra.1, for example).
{"sport": "soccer", "league": "eng.1", "date": "20261121"}On 2026-11-21 this returned the 7 Premier League matches of the day, each with event_id, state (post), clock ("90'+10'" for Newcastle United 2-2 Arsenal), venue and city, US broadcasters, both teams' scores, possession, shots and corners, and each team's recent form.
{"sport": "soccer", "league": "eng.1", "event_id": "401879232"}One match in full: boxscore, per-player stats, lineups, head-to-head, win probability and odds, by the event_id from scores.
{"sport": "basketball", "league": "nba"}The table: on 2026-11-21, 30 NBA teams in the Eastern and Western Conference with 22 stat fields each. Old calls to POST /sports-data/v1/<action> keep working unchanged; the call for ESPN is POST /espn/v1/<action>.
A dated scoreboard and table with ESPN's own ids, so every match and team can be opened again with summary, roster, team_schedule or odds.
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": { … },
"meta": {
"api": "espn",
"endpoint": "scores",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What an ESPN field actually contains
Fields that read differently from how they look. Each row was measured on live ESPN data on 2026-11-21 (NBA standings and the Premier League scoreboard of that day).
| Field | What it holds |
|---|---|
| sport + league | Sent together on every league action. league is a key from leagues (nba, nfl, mlb, nhl, eng.1, uefa.champions, ipl) or any other ESPN league code with its sport (soccer + bra.1). Cricket leagues are ESPN series numbers behind the keys. |
| status.state, completed, clock, period | state is pre, in or post; completed true after the final whistle. clock and period follow the sport: a Premier League match on 2026-11-21 ended with clock "90'+10'", period 2 (the half) and detail "FT". |
| event_id | ESPN's match id as text (401879232 = Newcastle United v Arsenal, 2026-11-21). It opens summary and odds for the same sport and league. |
| team_id | ESPN's team id as text, scoped to its league: in the NBA 13 = Los Angeles Lakers, 20 = Philadelphia 76ers, 15 = Milwaukee Bucks. It feeds roster, team and team_schedule. |
| standings[].stats | 22 fields per team, all as text: overall, Home, Road, vs. Div., vs. Conf., Last Ten Games, streak (W5, L13), gamesBehind, playoffSeed, winPercent, pointsFor, pointsAgainst, avgPointsFor, avgPointsAgainst, differential and more. |
| standings order | ESPN's order, not rank order: the first NBA row on 2026-11-21 was the Milwaukee Bucks (1-16, seed 15). Sort by stats.playoffSeed within each group (Eastern Conference, Western Conference). |
| home / away statistics | Per-team match stats on the score row: possessionPct, totalShots, shotsOnTarget, wonCorners, foulsCommitted, totalGoals. Arsenal had 13 shots and 66.4% possession at Newcastle on 2026-11-21. |
| records, form | The team's season record as ESPN prints it (Manchester City "7-1-3") and its last five results as a string ("DLWLW"). |
| odds | null when no betting line is open: all 7 finished Premier League matches of 2026-11-21 had odds null. Upcoming games carry provider, line and over/under. |
| broadcasts | The channels ESPN lists for the match, US-centric: Peacock, USA Net, Universo and Tele for the Premier League on 2026-11-21. |
Soccer seasons are named by the year they start (season 2026 = 2026-27). NBA standings come back with season null and the current table.
ESPN coverage, measured
Every number below comes from live calls on 2026-11-21; each answered in under one second.
The leagues action lists 30 league keys: soccer 14 (English Premier League eng.1, EFL Championship, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, MLS, Liga MX, Brazilian Serie A, Champions League, Europa League, World Cup), cricket 5 (IPL, Big Bash, Sheffield Shield, County Championship, Cricket World Cup), basketball 4 (NBA, WNBA, NCAA men and women), American football 2 (NFL, college), baseball 2 (MLB, college), tennis 2 (ATP, WTA), hockey 1 (NHL).
Premier League on 2026-11-21: 7 of 7 matches returned with final score, clock (90'+3' to 90'+10'), venue and city, broadcasters (Peacock, USA Net, Universo, Tele), possession, shots, shots on target, corners and fouls per team, the team's season record and its last-five form (Manchester City DLWLW).
NBA on 2026-11-21: 30 of 30 teams with team_id, conference and 22 fields each: overall, home and road record, division and conference record, last ten games, streak, games behind, playoff seed, points for and against. Leaders: Philadelphia 76ers 14-3 (East, seed 1) and Los Angeles Lakers 14-3 (West, seed 1, team_id 13).
Odds come only while a betting line is open: all 7 finished Premier League matches of 2026-11-21 had odds null. The odds action lists every scheduled game of a league that has a line.
Rows are in ESPN's order, not by rank: the first NBA row was the Milwaukee Bucks at 1-16 (seed 15), so sort by stats.playoffSeed. Stats come back as text ("14-3", ".824"). Golf, MMA and motor racing are not covered. search finds teams and players by name in TheSportsDB, an open sports database, so its ids are not ESPN ids.
What people build with ESPN
The jobs this data is most often used for.
Show live and final scores for the NFL, NBA, MLB, NHL or the Premier League in an app or on a site.
Build league tables with home, road, conference and last-ten records from standings.
Track injury reports and rosters for fantasy sports tools.
Collect moneyline, spread and over/under lines for scheduled games.
endpoints
credits per call
What ESPN data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/espn/v1/scores",
headers={"x-api-key": REEF_KEY},
json={
"sport": "soccer",
"league": "eng.1",
"dates": "20260301-20260331"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up ESPN.
Is there an ESPN API?▾
Yes. The ESPN API on ReefAPI returns ESPN scores, fixtures, standings, teams, rosters, match summaries, odds, injuries and news as JSON, with no ESPN account. Call POST /espn/v1/<action>, for example scores with sport soccer and league eng.1.
Which sports and leagues does the ESPN API cover?▾
30 league keys across 7 sports: soccer 14 (Premier League, EFL Championship, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, MLS, Liga MX, Brazilian Serie A, Champions League, Europa League, World Cup), cricket 5, basketball 4 (NBA, WNBA, NCAA men and women), American football 2 (NFL, college), baseball 2 (MLB, college), tennis 2 (ATP, WTA) and hockey 1 (NHL). Any other ESPN league code also works with its sport. Golf, MMA and motor racing are not covered.
How do I get today's or a past day's scores?▾
Call scores with sport and league, and date as YYYYMMDD for a day (or YYYYMMDD-YYYYMMDD for a range); omit date for today and live games. On 2026-11-21 sport soccer, league eng.1, date 20261121 returned the 7 Premier League matches of that day, all final, with score, clock, venue, broadcasters and team stats.
Can I get NBA, NFL, MLB or NHL standings?▾
Yes, with standings. On 2026-11-21 the NBA table returned 30 of 30 teams with 22 fields each: overall, home, road, division, conference and last-ten records, streak, games behind and playoff seed. The Philadelphia 76ers (14-3) led the East and the Los Angeles Lakers (14-3) the West. Rows come in ESPN's order; sort by stats.playoffSeed.
Does the ESPN API return betting odds?▾
Yes, while a line is open. odds returns moneyline, spread and over/under for one game by event_id, or for every scheduled game of a league that has a line. Finished games have odds null: all 7 Premier League matches played on 2026-11-21 did.
Can I get injury reports and rosters?▾
Yes. injuries returns the league's current injury report grouped by team, with each player's position, status, date and detail. roster returns a team's players with jersey, position, age, height, weight and nationality, by the ESPN team_id that standings, scores and team return (13 = Los Angeles Lakers).
Where do event_id and team_id come from?▾
From scores, fixtures, team_schedule (event_id) and from standings, scores or team (team_id). Both are ESPN's own numeric ids returned as text and scoped to the league. On 2026-11-21 Newcastle United v Arsenal was event_id 401879232; summary and odds take it.
Do old sports-data calls still work?▾
Yes. Calls to POST /sports-data/v1/<action> keep working unchanged with the same parameters and the same answer. The ESPN actions now have their own name: POST /espn/v1/<action>. The SofaScore actions moved to POST /sofascore/v1/<action>.
What is the ESPN API?▾
ESPN API is a ReefAPI endpoint group for espn scores, fixtures, standings, rosters, match summaries, odds, injuries and news for the nfl, nba, mlb, nhl, college sports, cricket and soccer, as json. It returns live JSON through POST requests under /espn/v1.
Is the ESPN API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. ESPN calls use the same shared credit balance as every other ReefAPI engine.
Do I need an ESPN login or account?▾
No login to ESPN is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the ESPN data?▾
The page example is captured from a live scores call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the ESPN API use?▾
ESPN actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call ESPN from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call espn actions with the same key, credit pool and JSON envelope used by normal REST requests.
47 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling ESPN, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.