Skip to main content

ESPN cross-league reference

Every league below exposes the same generated espn<League><Endpoint> surface (e.g. espnNbaScoreboard), bound from a single YAML source of truth. Each method is also available under its snake_case name (espn_nba_scoreboard) for parity with the Python / R packages. Pick a league for its full endpoint table, or try any call live in the playground.

Every endpoint also accepts { parsed: true } to return tidy rows instead of raw JSON — see ESPN parsed returns for the column reference (116 endpoints across 22 parsers).

Some leagues additionally ship native (non-ESPN) API wrappers — the MLB Stats API + Baseball Savant/Statcast (mlb), the four NHL native APIs (nhl), and the NFL.com Shield API (nfl). They're listed in the Native API sections of each league page; the native column below counts them.

LeaguesportESPN slugscopeswrappersnative
nbabasketballnbauniversal110
wnbabasketballwnbauniversal110
mbbbasketballmens-college-basketballuniversal, ncaa113
wbbbasketballwomens-college-basketballuniversal, ncaa113
cfbfootballcollege-footballuniversal, ncaa, football115
nflfootballnfluniversal, football11211
mlbbaseballmlbuniversal, mlb111117
nhlhockeynhluniversal110127
mchhockeymens-college-hockeyuniversal, ncaa113
wchhockeywomens-college-hockeyuniversal, ncaa113
college_baseballbaseballcollege-baseballuniversal, ncaa113
college_softballbaseballcollege-softballuniversal, ncaa113
uflfootballufluniversal110
xflfootballxfluniversal110
cflfootballcfluniversal110
soccersoccereng.1 *(param)*universal110
eplsoccereng.1universal110
laligasocceresp.1universal110
bundesligasoccerger.1universal110
serieasoccerita.1universal110
ligue1soccerfra.1universal110
mlssoccerusa.1universal110
ligamxsoccermex.1universal110
uclsocceruefa.championsuniversal110
uelsocceruefa.europauniversal110
nwslsoccerusa.nwsluniversal110
wwcsoccerfifa.wwcuniversal110
wcsoccerfifa.worlduniversal110
cricketcricketeng.1 *(param)*universal110

Standalone provider namespaces

Native providers that aren't a single ESPN league — each gets its own sdv.<namespace> surface and reference page. Cross-sport providers (odds, cbs, …) live under Providers in the sidebar; sport-specific ones (torvik → Basketball, hockeytech → Hockey) nest under their sport.

Namespacesportproviderwrappers
oddscross-sportThe Odds API10
recruitingcross-sport247Sports25
cbscross-sportCBS Sports82
foxcross-sportFox Sports38
yahoocross-sportYahoo Sports (scores), Yahoo Sports107
hockeytechHockeyHockeyTech / LeagueStat10
torvikBasketballBartTorvik (T-Rank)5
Same call, every league
await sdv.nba.espnNbaScoreboard({});
await sdv.nfl.espnNflScoreboard({ week: 1, seasonType: 2 });
await sdv.soccer.espnSoccerScoreboard({ league: 'eng.1' });
Native (non-ESPN) APIs
await sdv.mlb.mlbSchedule({ sportId: 1, date: '2024-07-01' });
await sdv.nhl.nhlApiWebPbp({ gameId: 2023030417, parsed: true });
await sdv.nfl.nflApiStandings({ season: 2024, seasonType: 'REG', week: 1 });