ESPN standings
League standings by conference, division or group: every team with its stats (wins, losses, ties, win %, games behind, points for/against, differential, streak, home/road/conference records, last ten, playoff seed, clinch marks; soccer: points, goal difference, rank ...), plus the seasons available.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
leaguerequired | string | League slug: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, soccer competitions (eng.1 Premier League, esp.1 LaLiga, ita.1, ger.1, fra.1, usa.1 MLS, uefa.champions, uefa.europa, fifa.world ...), f1, irl, nascar-premier, pga, lpga, atp, wta, ufc. Other ESPN leagues work with sport. Example: nfl |
sport | football | basketball | baseball | hockey | soccer | racing | golf | tennis | mma | lacrosse | volleyball | rugby | field-hockey | water-polo | australian-football | rugby-league | cricket | boxing | Only needed for a league not listed under league (it is inferred for those). |
season | integer | Season year (e.g. 2024; for NBA/NHL the year the season ends). Example: 2024 |
seasontype | 1 | 2 | 3 | 4 | 1 preseason, 2 regular season, 3 postseason, 4 off-season. |
level | 1 | 2 | 3 | 1 whole league, 2 conferences, 3 divisions. |
group | integer | Only this group id. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/espn/v1/standings?league=nfl" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/espn/v1/standings",
params={"league": "nfl"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/espn/v1/standings");
url.searchParams.set("league", "nfl");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).