Quickstart
A cross-sport tour of the package — its layout, naming, and return types. Start here, then jump to the notebook for your sport.
NBA
ESPN-backed NBA data: play-by-play, schedule, teams, game rosters. Wrappers follow the espnnba pattern; pre-built datasets load via load_nba_.
WNBA
A focused tour of the sdv.wnba submodule: teams, rosters, schedules, play-by-play, player and team season stats, standings, the draft, and the loadwnba* parquet loaders. Most calls hit ESPN's public API and return tidy polars frames.
MBB
ESPN-backed NCAA men's basketball: play-by-play, schedule, teams, game rosters. The espnmbb* surface mirrors the NBA wrappers — same shape, different league.
WBB
A tour of the NCAA women's basketball (sdv.wbb) submodule: teams, rosters, schedules, play-by-play, team stats, standings, conferences, and the parquet data loaders. The wrappers wrap ESPN's women's-college-basketball endpoints and return tidy polars frames (pass returnaspandas=True for pandas).
NFL
The NFL submodule mirrors nflreadpy so existing nflverse code can swap engines with minimal changes — its load_* functions read the same nflverse parquet releases.
CFB
ESPN-backed college football: play-by-play, schedule, teams, and per-play participant resolution. Wrappers follow the espncfb pattern; pre-built datasets load via load_cfb_.
MLB
Baseball from three sources: the MLB Stats API (mlbapi, backed by statsapi.mlb.com), Statcast pitch-level data (statcast_, from Baseball Savant), and ESPN MLB (espnmlb*).
NHL
Two hockey surfaces live under sportsdataverse.nhl:
PWHL
The Professional Women's Hockey League (PWHL) launched its inaugural season in 2024 with six teams: Boston, Minnesota, Montreal, New York, Ottawa, and Toronto. In sportsdataverse-py the PWHL is a loader-only league — there are no live API wrappers, just loadpwhl* functions that read pre-built parquet releases (schedules, boxscores, play-by-play, scoring/penalty summaries, rosters, and more) and return polars frames.