Skip to main content
Breaking in 4.0.0
  • Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
  • Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)

sdv.wbb — dataset loaders

34 loaders reading the published sportsdataverse-data releases (parquet) — the JS mirror of sportsdataverse-py's load_* functions. Each is a camelCase export plus its snake_case alias and resolves to an array of plain row objects (or { [column]: values[] } with format: "columns").

  • Size: row objects cost ~60-100 bytes per cell on the heap, so before decoding each season a loader adds its rows × columns (from the parquet footer) to a running total and checks it against maxCells — by default heap limit / 100 for rows (≈45M cells on Node's default 4 GB heap) and heap limit / 30 for format: "columns" — and throws a catchable SdvError instead of running out of memory. Play-by-play is the usual case: pass columns, use format: "columns", or raise the heap (node --max-old-space-size=8192).
  • Seasons: seasons takes one season or a list. A season with no published asset (HTTP 404) is skipped with a warning (loaders marked so in their seasons row — sdv-py's hand-written ones — throw NoDataError instead); any other failure raises AssetFetchError (a failed download is never an empty season); a season below the loader's floor raises SeasonNotFoundError before anything is fetched. Multi-season results union the columns, null-filling gaps, and cast a column whose type changed between seasons to the common type (an integer id that became a string → strings, "123" not "123.0"), as sdv-py's diagonal_relaxed concat does.
  • Integers: an id column (id, *_id, *_ids, game_pk, athlete_id_1, id_play, playerId, homeTeamId, start.team.id, …) of integers comes back as exact decimal strings in every row and every season, whatever width the release stores it with (INT32, INT64, or a DOUBLE holding integers: "401628579101849903", "39", never "39.0"), so ids join across seasons and across releases. Code-like id columns (type_id, status_id, …) are strings too. An id column that is not exact integers (a fraction, a DOUBLE past 2^53) is left as read with one warning. Any other INT64 column comes back as number when every value is a safe integer, otherwise as BigInt with one warning (code SDV_INT64) per column per process.
  • Runtime: Node only. Downloads go through the releases transport family (see Transport, auth & errors); each asset is downloaded whole, then decoded.
LoaderReleaseSeasons
loadWbbPbpespn_womens_college_basketball_pbp2002+
loadWbbPlayerBoxscoreespn_womens_college_basketball_player_boxscores2002+
loadWbbScheduleespn_womens_college_basketball_schedules2002+
loadWbbTeamBoxscoreespn_womens_college_basketball_team_boxscores2002+
loadWbbRatingswbb_ratings2008+
loadWbbPlayerValuewbb_player_value2014+
loadWbbGameRostersespn_womens_college_basketball_game_rosters2026+
loadWbbOfficialsespn_womens_college_basketball_officials2026+
loadWbbPlayerSeasonStatsespn_womens_college_basketball_player_season_stats2026+
loadWbbRostersespn_womens_college_basketball_rosters2026+
loadWbbShotsespn_womens_college_basketball_shots2026+
loadWbbStandingsespn_womens_college_basketball_standings2026+
loadWbbTeamSeasonStatsespn_womens_college_basketball_team_season_stats2026+
loadWbbPlayerCrosswalkwbb_crosswalk2014+
loadWbbScheduleCrosswalkwbb_crosswalk2026+
loadWbbTeamCrosswalkwbb_crosswalk2014+
loadWbbPlayerCoreespn_womens_college_basketball_player_core2004+
loadNcaaWbbRapmncaa_wbb_rapm2011+
loadNcaaWbbPbpncaa_wbb_pbp2010+
loadNcaaWbbSchedulencaa_wbb_schedule2010+
loadNcaaWbbPlayerBoxncaa_wbb_player_box2010+
loadNcaaWbbTeamBoxncaa_wbb_team_box2010+
loadNcaaWbbRostersncaa_wbb_rosters2010+
loadNcaaWbbTeamRostersncaa_wbb_team_rosters2010+
loadNcaaWbbTeamIdsncaa_wbb_team_ids2010+
loadNcaaWbbPossessionsncaa_wbb_possessions2010+
loadNcaaWbbLineupsncaa_wbb_lineups2010+
loadNcaaWbbMatchupStintsncaa_wbb_matchup_stints2010+
loadNcaaWbbShotsncaa_wbb_shots2019+
loadNcaaWbbRapmWithinTeamncaa_wbb_rapm_within_team2010+
loadWbbGroupswbb_groupsone asset
loadWbbGroupSeasonswbb_groupsone asset
loadWbbGroupAliaseswbb_groupsone asset
loadWbbTeamGroupSeasonswbb_groups2002+

loadWbbPbp​

Release: espn_womens_college_basketball_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_pbp/play_by_play_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPbp({ seasons: 2024, columns: ['game_id', 'sequence_number', 'type_text', 'text', 'score_value'] });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_pbp(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPbpRow (exported from the package root).

col_nametypedescription
game_play_numbernumberGame play number
idstringUnique play identification number
sequence_numbernumberSequence number representing a shot-possession (V3 PBP).
type_idstringType identifier (numeric).
type_textstringPlay type text, passed through verbatim from ESPN. ESPN labels the free-throw play type "MadeFreeThrow" for made AND missed free throws; filter makes vs. misses with scoring_play, not type_text.
textstringText description of the play / record.
away_scorenumberAway team's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
home_scorenumberHome team's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
period_numbernumberNumeric period (1-4 for quarters; 5+ for OT).
period_display_valuestringPeriod display label (e.g. '1st Quarter', 'OT').
clock_display_valuestringGame clock display string (e.g. '8:32').
scoring_playbooleanTRUE if the play resulted in points scored.
score_valuenumberPoint value of the attempt (1 / 2 / 3), carried even on misses (a missed free throw still shows 1); use scoring_play to identify points actually scored.
wallclockstringWallclock.
shooting_playbooleanTRUE if the play was a shooting attempt.
coordinate_x_rawnumberX coordinate as returned by the API before any adjustment.
coordinate_y_rawnumberY coordinate as returned by the API before any adjustment.
points_attemptednumberPoint value at stake on the shot attempt (3 for threes, 2 for other field goals, 1 for free throws), from the ESPN play type.
short_descriptionstringShortened version of ESPN's play description text, without score context.
team_idstringUnique team identifier.
athlete_id_1stringPrimary athlete identifier (e.g. shooter).
athlete_id_2stringSecondary athlete identifier (e.g. assister / fouler).
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_idstringUnique identifier for the home team.
home_team_namestringHome team name.
home_team_mascotstringHome team mascot.
home_team_abbrevstringHome team three-letter abbreviation.
home_team_name_altstringAlternate versions of the home team abbreviation
away_team_idstringUnique identifier for the away team.
away_team_namestringAway team name.
away_team_mascotstringAway team mascot.
away_team_abbrevstringAway team three-letter abbreviation.
away_team_name_altstringAlternate versions of the away team abbreviation
game_spreadnumberGame spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
home_favoritebooleanLogical (TRUE/FALSE) indicating whether the home team is favored
game_spread_availablebooleanLogical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first
home_team_spreadnumberThe game spread with respect to the home team
qtrnumberQuarter of the game
timestringTime left within the period
clock_minutesnumberClock minutes split from seconds for developer convenience
clock_secondsnumberClock seconds split from minutes for developer convenience
home_timeout_calledbooleanFlag set on plays where a timeout was charged to the home team.
away_timeout_calledbooleanFlag set on plays where a timeout was charged to the away team.
halfnumberHalf of the game
game_halfnumberHalf of the game
lag_qtrnumberA lag column on the quarter
lead_qtrnumberA lead column on the quarter
lag_halfnumberA lag column on the half
lead_halfnumberA lead column on the half
start_quarter_seconds_remainingnumberQuarter seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_half_seconds_remainingnumberGame half seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_game_seconds_remainingnumberGame seconds remaining at the start of the play (''')
end_quarter_seconds_remainingnumberQuarter seconds remaining at the end of the play (''')
end_half_seconds_remainingnumberGame half seconds remaining at the end of the play (''')
end_game_seconds_remainingnumberGame seconds remaining at the end of the play (''')
periodnumberPeriod of the game (1-4 quarters; 5+ for OT).
coordinate_xnumberX coordinate on the court (half-court layout).
coordinate_ynumberY coordinate on the court (half-court layout).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
espn_home_wpnumberESPN's own published win probability for the home team (0-1), carried through unchanged.
espn_tie_percentagenumberESPN's published tie probability; present in the feed but always 0.0 in the published asset.
espn_away_wpnumberESPN's own published win probability for the away team (0-1), carried through unchanged.
athlete_name_1stringDisplay name of the first athlete in the ESPN play participants (e.g., the shooter on a shot attempt).
athlete_name_2stringDisplay name of the second athlete in the ESPN play participants (e.g., the assisting player), when present.
athlete_name_3stringDisplay name of the third athlete in the ESPN play participants, when present.
score_sourcestringWhere this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair. Select it by name: it is the play-by-play builder's last column, but a release can carry columns after it.
pregame_home_probnumberModel's pre-game win probability for the home team (0-1), constant within a game. Present only on assets published with the WP model (2012-13 onward); absent on earlier seasons (rules/wbb.yaml#wbb-2013-pbp-wp-columns).
home_win_probnumber

loadWbbPlayerBoxscore​

Release: espn_womens_college_basketball_player_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_player_boxscores/player_box_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPlayerBoxscore({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_player_boxscore(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPlayerBoxscoreRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
athlete_idstringUnique athlete identifier (ESPN).
athlete_display_namestringAthlete display name (full).
team_idstringUnique team identifier.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_locationstringTeam city or location string.
team_short_display_namestringShort team display name (e.g. 'Aces').
minutesnumberMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madenumberField goals made (2-pt + 3-pt).
field_goals_attemptednumberField goal attempts (2-pt + 3-pt).
three_point_field_goals_madenumberThree-point field goals made.
three_point_field_goals_attemptednumberThree-point field goal attempts.
free_throws_madenumberFree throws made.
free_throws_attemptednumberFree throw attempts.
offensive_reboundsnumberOffensive rebounds.
defensive_reboundsnumberDefensive rebounds.
reboundsnumberTotal rebounds.
assistsnumberTotal assists.
stealsnumberTotal steals.
blocksnumberTotal blocks.
turnoversnumberTotal turnovers.
foulsnumberPersonal fouls.
pointsnumberPoints scored.
starterbooleanTRUE if the player was in the starting lineup; FALSE otherwise.
ejectedbooleanTRUE if the player was ejected from the game.
did_not_playbooleanTRUE if the player did not appear in the game.
activebooleanTRUE if the row represents an active record (player / team / season).
athlete_jerseystringAthlete jersey number.
athlete_short_namestringAthlete short display name.
athlete_headshot_hrefstringAthlete headshot image URL.
athlete_position_namestringAthlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviationstringAthlete position abbreviation (G / F / C).
team_display_namestringFull team display name.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logostringTeam logo image URL.
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
home_awaystringGame venue label ('home' or 'away').
team_winnerbooleanTRUE if the team won this game.
team_scorenumberTeam's score / final score.
opponent_team_idstringUnique identifier for the opponent team.
opponent_team_namestringOpponent team display name.
opponent_team_locationstringOpponent team city / location.
opponent_team_display_namestringOpponent team full display name.
opponent_team_abbreviationstringOpponent team abbreviation.
opponent_team_logostringOpponent team logo URL.
opponent_team_colorstringOpponent team primary color (hex).
opponent_team_alternate_colorstringOpponent team alternate color (hex).
opponent_team_scorenumberOpponent team's score.

loadWbbSchedule​

Release: espn_womens_college_basketball_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_schedules/wbb_schedule_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbSchedule({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_schedule(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbScheduleRow (exported from the package root).

col_nametypedescription
idstringUnique play identification number
uidstringESPN UID string.
datestringDate in YYYY-MM-DD format.
attendancenumberReported attendance.
time_validbooleanTime valid.
neutral_sitebooleanNeutral site.
conference_competitionbooleanConference competition.
play_by_play_availableboolean
recentbooleanRecent.
start_datestringStart date (YYYY-MM-DD).
broadcaststringBroadcast information string.
highlightsstring
notes_typestringNotes type.
notes_headlinestringNotes headline.
broadcast_marketstringBroadcast market label (e.g. 'national', 'home').
broadcast_namestringBroadcast name.
type_idstringType identifier (numeric).
type_abbreviationstringPlay type abbreviation
venue_idstringUnique venue identifier.
venue_full_namestringVenue full name.
venue_address_citystringVenue address city.
venue_address_statestringVenue address state / region.
venue_indoorbooleanTRUE if the venue is indoors.
status_clocknumberStatus clock.
status_display_clockstringStatus display clock.
status_periodnumberStatus period.
status_type_idstringUnique identifier for status type.
status_type_namestringStatus type name.
status_type_statestringStatus type state.
status_type_completedbooleanStatus type completed.
status_type_descriptionstringStatus type description.
status_type_detailstringStatus type detail.
status_type_short_detailstringStatus type short detail.
format_regulation_periodsnumberFormat regulation periods.
home_idstringUnique identifier for home.
home_uidstringHome team's uid.
home_locationstringHome team's location.
home_namestringHome name.
home_abbreviationstringHome team's abbreviation.
home_display_namestringHome display name.
home_short_display_namestringHome short display name.
home_colorstringColor code (hex) for home.
home_alternate_colorstringColor code (hex) for home alternate.
home_is_activebooleanHome team's is active.
home_venue_idstringUnique identifier for home venue.
home_logostringHome team logo URL.
home_conference_idstringUnique identifier for home conference.
home_scorenumberHome team score at the time of the play.
home_winnerbooleanHome team's winner.
home_current_ranknumberPoll ranking ESPN listed for the home team at game time (unranked teams carry a sentinel value).
home_linescoresstringPeriod-by-period scores for the home team as a delimited string from ESPN's schedule feed.
home_recordsstringRecord strings (overall and split records) for the home team from ESPN's schedule feed.
away_idstringUnique identifier for away.
away_uidstringAway team's uid.
away_locationstringAway team's location.
away_namestringAway name.
away_abbreviationstringAway team's abbreviation.
away_display_namestringAway display name.
away_short_display_namestringAway short display name.
away_colorstringColor code (hex) for away.
away_alternate_colorstringColor code (hex) for away alternate.
away_is_activebooleanAway team's is active.
away_venue_idstringUnique identifier for away venue.
away_logostringAway team logo URL.
away_conference_idstringUnique identifier for away conference.
away_scorenumberAway team score at the time of the play.
away_winnerbooleanAway team's winner.
away_current_ranknumberPoll ranking ESPN listed for the away team at game time (unranked teams carry a sentinel value).
away_linescoresstringPeriod-by-period scores for the away team as a delimited string from ESPN's schedule feed.
away_recordsstringRecord strings (overall and split records) for the away team from ESPN's schedule feed.
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
status_type_alt_detailstringStatus type alt detail.
tournament_idstringESPN tournament identifier.
groups_idstringUnique identifier for groups.
groups_namestringGroups name.
groups_short_namestringGroups short name.
groups_is_conferencebooleanGroups is conference.
game_jsonboolean
game_json_urlstring
has_game_jsonbooleanWhether the raw game JSON payload exists in the raw store for this game.
game_json_raw_urlstringraw.githubusercontent.com URL of the game's raw JSON payload in wehoop-wbb-raw.
game_rosters_json_urlstringraw.githubusercontent.com URL of the game's rosters JSON payload in wehoop-wbb-raw.
has_game_rosters_jsonbooleanWhether the rosters JSON payload exists in the raw store for this game.
officials_json_urlstringraw.githubusercontent.com URL of the game's officials JSON payload in wehoop-wbb-raw.
has_officials_jsonbooleanWhether the officials JSON payload exists in the raw store for this game.
game_date_timeDateGame start date/time (ISO 8601).
game_dateDateGame date (YYYY-MM-DD).
PBPboolean
team_boxbooleanTeam box.
player_boxbooleanPlayer box.
in_shotsbooleanWhether the game is represented in the built shots dataset.
in_game_rostersbooleanWhether the game is represented in the built game-rosters dataset.
in_officialsbooleanWhether the game is represented in the built officials dataset.

loadWbbTeamBoxscore​

Release: espn_womens_college_basketball_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_team_boxscores/team_box_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbTeamBoxscore({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_team_boxscore(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbTeamBoxscoreRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
team_idstringUnique team identifier.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationstringTeam city or location string.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
team_home_awaystringTeam home away.
team_scorenumberTeam's score / final score.
team_winnerbooleanTRUE if the team won this game.
assistsnumberTotal assists.
blocksnumberTotal blocks.
defensive_reboundsnumberDefensive rebounds.
fast_break_pointsstringFast-break points scored.
field_goal_pctnumberField goal percentage (0-1).
field_goals_madenumberField goals made (2-pt + 3-pt).
field_goals_attemptednumberField goal attempts (2-pt + 3-pt).
foulsnumberPersonal fouls.
free_throw_pctnumberFree throw percentage (0-1).
free_throws_madenumberFree throws made.
free_throws_attemptednumberFree throw attempts.
largest_leadstringLargest lead during the game.
offensive_reboundsnumberOffensive rebounds.
points_in_paintstringPoints scored in the paint.
stealsnumberTotal steals.
team_turnoversnumberTeam turnovers (turnovers credited to the team rather than a player).
technical_foulsnumberTotal technical fouls.
three_point_field_goal_pctnumberThree-point field goal percentage (0-1).
three_point_field_goals_madenumberThree-point field goals made.
three_point_field_goals_attemptednumberThree-point field goal attempts.
total_reboundsnumberTotal rebounds.
total_technical_foulsnumberTotal technical fouls (player + team).
total_turnoversnumberTotal turnovers (player + team).
turnover_pointsstringTurnover points.
turnoversnumberTotal turnovers.
opponent_team_idstringUnique identifier for the opponent team.
opponent_team_uidstringOpponent team uid.
opponent_team_slugstringOpponent team slug.
opponent_team_locationstringOpponent team city / location.
opponent_team_namestringOpponent team display name.
opponent_team_abbreviationstringOpponent team abbreviation.
opponent_team_display_namestringOpponent team full display name.
opponent_team_short_display_namestringOpponent team short display name.
opponent_team_colorstringOpponent team primary color (hex).
opponent_team_alternate_colorstringOpponent team alternate color (hex).
opponent_team_logostringOpponent team logo URL.
opponent_team_scorenumberOpponent team's score.
lead_changesstringLead changes.
lead_percentagestringShare of game time the team held the lead, as reported in ESPN's team boxscore.

loadWbbRatings​

Release: wbb_ratings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_ratings/wbb_ratings_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2008)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbRatings({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_ratings(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbRatingsRow (exported from the package root).

col_nametypedescription
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
adj_onumberAdj o.
adj_dnumberAdj d.
adj_emnumberAdj em.
adj_temponumberOpponent-adjusted tempo in possessions per 40 minutes, produced by the same fixed-point adjustment as the efficiencies applied to game possessions under the additive model poss = tempo_i + tempo_j minus the league baseline.
raw_onumberRaw o.
raw_dnumberRaw d.
gamesnumber | bigintGames played.
ranknumber | bigintRank.
adj_em_znumberWithin-season z-score of adj_em, computed as adj_em minus the season mean divided by the season standard deviation over every team in the frame, so it is mean 0 and standard deviation 1 per season.

loadWbbPlayerValue​

Release: wbb_player_value · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_player_value/wbb_player_value_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2014)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPlayerValue({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_player_value(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPlayerValueRow (exported from the package root).

col_nametypedescription
player_idstringUnique player identifier.
playerstringPlayer name.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
minnumberMinutes played.
box_obpmnumberBox-score offensive plus/minus for the player, the offensive half of box BPM.
box_dbpmnumberBox-score defensive plus/minus for the player, the defensive half of box BPM.
box_bpmnumberTotal box plus/minus in points per 100 possessions above average, exactly box_obpm plus box_dbpm in every published row.
qualifiedboolean

loadWbbGameRosters​

Release: espn_womens_college_basketball_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_game_rosters/game_rosters_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbGameRosters({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_game_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbGameRostersRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
home_awaystringGame venue label ('home' or 'away').
athlete_idstringUnique athlete identifier (ESPN).
athlete_uidstringESPN athlete UID (universal identifier).
athlete_guidstringESPN athlete GUID.
athlete_display_namestringAthlete display name (full).
athlete_short_namestringAthlete short display name.
athlete_first_namestring
athlete_last_namestring
athlete_jerseystringAthlete jersey number.
athlete_positionstringAthlete position.
athlete_headshotstringURL of the player's ESPN headshot image on a.espncdn.com, whose filename is the athlete_id; null when ESPN publishes no headshot for that player.
starterbooleanTRUE if the player was in the starting lineup; FALSE otherwise.
did_not_playbooleanTRUE if the player did not appear in the game.
activebooleanTRUE if the row represents an active record (player / team / season).
ejectedbooleanTRUE if the player was ejected from the game.
reasonstringReason.

loadWbbOfficials​

Release: espn_womens_college_basketball_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_officials/officials_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbOfficials({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_officials(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbOfficialsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.
official_idstringUnique official / referee identifier.
official_uidstringESPN's globally unique resource identifier for the official, read from the core-api items[] uid key; that payload never ships it, so the column is null for every published row.
official_full_namestringESPN's fullName for the official, falling back to displayName when fullName is absent; ESPN sometimes ships it with a middle initial or a doubled internal space, so it is not simply first plus last name.
official_display_namestringESPN's displayName for the official, which is identical to official_full_name in every published row of the released data.
official_first_namestringThe official's given name as ESPN splits it out separately from the full name, excluding any middle initial that appears in official_full_name.
official_last_namestringThe official's surname as ESPN splits it out; joined to official_first_name it reconstructs roughly 98 percent of official_full_name values, the rest differing by middle initials or spacing.
official_ordernumberESPN's 1-based sequence of the official within that game's crew listing, unique within a game and running 1 to 3 for the standard three-person crew.
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_display_namestringPosition display name.

loadWbbPlayerSeasonStats​

Release: espn_womens_college_basketball_player_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_player_season_stats/player_season_stats_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPlayerSeasonStats({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_player_season_stats(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPlayerSeasonStatsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
athlete_idstringUnique athlete identifier (ESPN).
athlete_display_namestringAthlete display name (full).
athlete_first_namestring
athlete_last_namestring
athlete_position_abbreviationstringAthlete position abbreviation (G / F / C).
athlete_jerseystringAthlete jersey number.
team_idstringUnique team identifier.
team_display_namestringFull team display name.
categorystringCategory label.
stat_labelstring
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_descriptionstringESPN's prose definition of the statistic named in stat_name, for example The average assists per game for avgAssists; combined made-attempted stats carry both definitions joined by a hyphen.
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWbbRosters​

Release: espn_womens_college_basketball_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_rosters/rosters_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbRosters({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbRostersRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
athlete_idstringUnique athlete identifier (ESPN).
uidstringESPN UID string.
guidstringStable cross-league team GUID.
full_namestringPlayer's full name.
display_namestringDisplay name.
short_namestringShort display name.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
jerseystringJersey number worn by the player.
position_abbreviationstringPosition abbreviation ('G' / 'F' / 'C').
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_idstringUnique position identifier.
heightstringPlayer height (string e.g. '6-2' or inches).
weightstringPlayer weight in pounds.
agestringPlayer age (in years).
date_of_birthstringDate of birth (YYYY-MM-DD).
birth_place_citystringBirth place city.
birth_place_statestringBirth place state.
birth_place_countrystringBirth place country.
experience_yearsstringExperience years.
experience_display_valuestringExperience display value.
headshot_hrefstringHeadshot image URL.
headshot_altstringAlternative-text label for the headshot.
link_webstringWeb link / URL.
status_idstringStatus identifier.
status_namestringStatus label.
status_typestringStatus type.

loadWbbShots​

Release: espn_womens_college_basketball_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_shots/shots_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbShots({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_shots(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbShotsRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
period_numbernumberNumeric period (1-4 for quarters; 5+ for OT).
clock_display_valuestringGame clock display string (e.g. '8:32').
team_idstringUnique team identifier.
athlete_id_1stringPrimary athlete identifier (e.g. shooter).
athlete_id_2stringSecondary athlete identifier (e.g. assister / fouler).
type_idstringType identifier (numeric).
type_textstringDisplay text for the type field.
scoring_playbooleanTRUE if the play resulted in points scored.
score_valuenumberPoint value of the play (2 / 3 / 1).
coordinate_xnumberX coordinate on the court (half-court layout).
coordinate_ynumberY coordinate on the court (half-court layout).
coordinate_x_rawnumberX coordinate as returned by the API before any adjustment.
coordinate_y_rawnumberY coordinate as returned by the API before any adjustment.
athlete_name_1stringDisplay name of the shooter credited on the attempt in ESPN's play participants.
athlete_name_2stringDisplay name of the second athlete tied to the attempt (typically the assister), when present.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_mascotstringMascot/nickname of the shooting team from ESPN's team record.
team_abbrevstringAbbreviation for team.

loadWbbStandings​

Release: espn_womens_college_basketball_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_standings/standings_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbStandings({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_standings(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbStandingsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
group_idstringESPN group id.
group_namestring
group_abbreviationstring
group_short_namestringShort display name of the conference or division grouping the row belongs to.
team_idstringUnique team identifier.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationstringTeam city or location string.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_short_display_namestring
stat_descriptionstringESPN's longer wording for the standings stat, for example Overall Record for the Team Season Record entry and Current Streak for Streak; null for stats ESPN ships without one, such as vs AP Top 25.
stat_abbreviationstringESPN's abbreviation for the standings stat, such as GB, OPP PPG or VS CONF; always populated and matching stat_short_display_name for about 90 percent of rows.
stat_typestringStat type code (e.g. "win", "loss").
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWbbTeamSeasonStats​

Release: espn_womens_college_basketball_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_team_season_stats/team_season_stats_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbTeamSeasonStats({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_team_season_stats(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbTeamSeasonStatsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
categorystringCategory label.
stat_labelstring
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_descriptionstringESPN's prose definition of the team statistic named in stat_name, for example The average blocks per game for avgBlocks or the full sentence defining a blocked shot for blocks.
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWbbPlayerCrosswalk​

Release: wbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_crosswalk/wbb_player_crosswalk_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2014)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPlayerCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_player_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPlayerCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
espn_team_idstringESPN team id (canonical key).
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
player_namestringPlayer name.
espn_athlete_idstringESPN athlete id.
espn_full_namestringESPN full name.
espn_jerseystringESPN jersey number.
espn_positionstringESPN position abbreviation.
fox_athlete_idstringFox athlete id (NA if unmatched).
fox_playerstringFox player name (NA if unmatched).
fox_jerseystringFox jersey number (NA if unmatched).
fox_position_groupstringFox position group label (NA if unmatched).
yahoo_player_idstringYahoo player id (NA placeholder).
yahoo_player_namestringYahoo player name (NA placeholder).
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidencenumberJaro-Winkler score or 1 for exact (NA if none).
match_keysstringNA (reserved for future use).

loadWbbScheduleCrosswalk​

Release: wbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_crosswalk/wbb_schedule_crosswalk_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbScheduleCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_schedule_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbScheduleCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_dateDateGame date (YYYY-MM-DD).
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_espn_team_idstringESPN away team id (NA for bart-only rows).
espn_game_idstringESPN game id (NA for bart-only rows).
bart_muidstringTorvik muid (NA for espn-only rows).
bart_team1stringTorvik team1 name (NA for espn-only rows).
bart_team2stringTorvik team2 name (NA for espn-only rows).
bart_winnerstringTorvik winner name (NA for espn-only rows).
fox_game_idstringFox Sports game id (string), filled when the crosswalk is built with fox=True from Fox's per-date scoreboard, matched on the US-Eastern date and the two teams in either home/away order; null otherwise and where Fox lists no matching game.
yahoo_game_idstringYahoo Sports game id, ncaaw.g.<YYYYMMDD US-Eastern date><home Yahoo team id, 4 digits>, filled when built with yahoo=True and checked against the ids Yahoo lists, so a neutral-site game carries the side Yahoo calls home; null otherwise and where Yahoo lists no such game (a non-Division-I home team).
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidencenumberJaro-Winkler score or 1 for exact (NA if none).

loadWbbTeamCrosswalk​

Release: wbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_crosswalk/wbb_team_crosswalk_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2014)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbTeamCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_team_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbTeamCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
espn_team_idstringESPN team id (canonical key).
espn_abbreviationstringESPN abbreviation.
espn_display_namestringESPN display name (school + mascot).
espn_short_namestringESPN short name.
espn_locationstringESPN school/location only.
espn_mascotstringESPN team mascot/nickname.
espn_conferencestringESPN conference name.
fox_team_idstringFox Bifrost team id (NA if unmatched).
fox_team_namestringFox team name (NA if unmatched).
fox_sectionstringFox conference/section label (NA if unmatched).
bart_teamstringTorvik team name (NA if unmatched).
bart_confstringTorvik conference abbreviation (NA if unmatched).
yahoo_team_idstringDotted Yahoo Sports team id (e.g. 'ncaab.t.173'), filled when built with yahoo=True from Yahoo's team listing joined on full name, short name, then nickname; null otherwise and where no Yahoo team matched.
yahoo_team_namestringYahoo Sports full team name for yahoo_team_id; null when yahoo_team_id is.
fox_match_confidencenumber1 for matched, NA for unmatched.
bart_match_confidencenumber1 for matched, NA for unmatched.
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".

loadWbbPlayerCore​

Release: espn_womens_college_basketball_player_core · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_womens_college_basketball_player_core/player_core_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2004)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbPlayerCore({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_player_core(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbPlayerCoreRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
athlete_idstringUnique athlete identifier (ESPN).
guidstringStable cross-league team GUID.
uidstringESPN UID string.
slugstringURL-safe identifier.
typestringRecord type / category.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
full_namestringPlayer's full name.
display_namestringDisplay name.
short_namestringShort display name.
heightnumberPlayer height (string e.g. '6-2' or inches).
display_heightstringPlayer height in display format (e.g. '6-2').
weightnumberPlayer weight in pounds.
display_weightstringPlayer weight in display format (e.g. '180 lbs').
agenumberPlayer age (in years).
date_of_birthstringDate of birth (YYYY-MM-DD).
birth_citystringBirth city.
birth_statestringBirth state / region.
birth_countrystring
jerseystringJersey number worn by the player.
position_idstringUnique position identifier.
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_abbreviationstringPosition abbreviation ('G' / 'F' / 'C').
position_display_namestringPosition display name.
college_idstringUnique identifier for college.
current_team_idstring
headshot_hrefstringHeadshot image URL.
experience_yearsnumberExperience years.
status_idstringStatus identifier.
status_namestringStatus label.
status_typestringStatus type.
draft_yearnumberDraft year (4-digit).
draft_roundnumberRound of the draft selection.
draft_selectionnumberDraft selection.
activebooleanTRUE if the row represents an active record (player / team / season).

loadNcaaWbbRapm​

Release: ncaa_wbb_rapm · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_rapm/ncaa_wbb_rapm_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2011)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbRapm({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_rapm(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbRapmRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
player_idstringUnique player identifier.
person_idstringUnique player identifier (V3 endpoints).
playerstringPlayer name.
teamstringTeam-side label or team identifier.
orapmnumberOffensive regularized adjusted plus-minus: points contributed per 100 possessions on offense, adjusted for the other 9 players on the floor.
drapmnumberDefensive regularized adjusted plus-minus: points prevented per 100 possessions on defense (higher is better defense), adjusted for the other 9 players on the floor.
rapm_netnumberNet RAPM (orapm plus drapm): overall point contribution per 100 possessions. Verified against live data: rapm_net == orapm + drapm exactly.
off_possnumber | bigintOffensive possessions the player was on court for; the regression weight behind orapm.
def_possnumber | bigintDefensive possessions the player was on court for; the regression weight behind drapm.
estimandstringFit-scope tag for the RAPM model that produced this row (observed value: 'league', a Division I-wide fit) -- one row per player-season, not per estimand.

loadNcaaWbbPbp​

Release: ncaa_wbb_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_pbp/ncaa_wbb_pbp_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbPbp({ seasons: 2024, columns: ['game_date', 'home', 'away', 'period', 'event_type', 'shot_value'] });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_pbp(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbPbpRow (exported from the package root).

col_nametypedescription
game_datestringGame date (YYYY-MM-DD).
homestringHome.
awaystringAway record.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
clockstringGame clock value.
game_timestringGame start time.
game_secondsnumber | bigint
home_scorenumber | bigintHome team score at the time of the play.
away_scorenumber | bigintAway team score at the time of the play.
event_teamstring
event_descriptionstring
player_1stringName of the primary player credited on the event (shooter, fouler, rebounder, etc.), as scraped from stats.ncaa.org.
player_2stringName of the secondary player on the event (e.g., the assister or the player subbed for), when present.
event_typestringEvent / play type code (V2 PBP).
event_resultstringOutcome of the event, e.g. made or missed for shot attempts.
shot_valuenumber | bigintPoint value of the shot (2 or 3).
event_lengthnumber | bigintSeconds elapsed between this event and the previous event in the game.
poss_numnumber | bigintSequential possession number within the game that the event belongs to.
poss_teamstringName of the team in possession when the event occurred.
poss_lengthnumber | bigintDuration of the enclosing possession in seconds.
is_transitionbooleanFlag marking events that occurred in transition, within the opening seconds of the possession.
home_1stringName of the home team's on-floor player in lineup slot 1 for the event, from the substitution walk-forward.
home_2stringName of the home team's on-floor player in lineup slot 2 for the event, from the substitution walk-forward.
home_3stringName of the home team's on-floor player in lineup slot 3 for the event, from the substitution walk-forward.
home_4stringName of the home team's on-floor player in lineup slot 4 for the event, from the substitution walk-forward.
home_5stringName of the home team's on-floor player in lineup slot 5 for the event, from the substitution walk-forward.
away_1stringName of the away team's on-floor player in lineup slot 1 for the event, from the substitution walk-forward.
away_2stringName of the away team's on-floor player in lineup slot 2 for the event, from the substitution walk-forward.
away_3stringName of the away team's on-floor player in lineup slot 3 for the event, from the substitution walk-forward.
away_4stringName of the away team's on-floor player in lineup slot 4 for the event, from the substitution walk-forward.
away_5stringName of the away team's on-floor player in lineup slot 5 for the event, from the substitution walk-forward.
statusstringStatus label.
is_garbage_timebooleanFlag marking events in garbage time under the score-margin and clock rule of the pbp builder.
sub_deviatenumber | bigintPer-game count of substitution-tracking deviations found while walking lineups forward; nonzero flags imperfect substitution data.
contest_idstring
home_ncaa_team_idstringstats.ncaa.org team identifier for the home team.
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_ncaa_team_idstringstats.ncaa.org team identifier for the away team.
away_espn_team_idstringESPN away team id (NA for bart-only rows).
event_team_ncaa_team_idstringstats.ncaa.org team identifier of the team credited with the event.
event_team_espn_team_idstringESPN team identifier of the team credited with the event, via the NCAA-to-ESPN crosswalk.
poss_team_ncaa_team_idstringstats.ncaa.org team identifier of the team in possession.
poss_team_espn_team_idstringESPN team identifier of the team in possession, via the NCAA-to-ESPN crosswalk.
player_1_idstringstats.ncaa.org player identifier for player_1, resolved through the roster name matcher.
player_1_clean_namestringNormalized (diacritics- and punctuation-cleaned) name for player_1.
player_2_idstringstats.ncaa.org player identifier for player_2, resolved through the roster name matcher.
player_2_clean_namestringNormalized (diacritics- and punctuation-cleaned) name for player_2.
home_1_player_idstringstats.ncaa.org player identifier for the home slot-1 on-floor player.
home_1_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-1 on-floor player.
home_2_player_idstringstats.ncaa.org player identifier for the home slot-2 on-floor player.
home_2_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-2 on-floor player.
home_3_player_idstringstats.ncaa.org player identifier for the home slot-3 on-floor player.
home_3_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-3 on-floor player.
home_4_player_idstringstats.ncaa.org player identifier for the home slot-4 on-floor player.
home_4_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-4 on-floor player.
home_5_player_idstringstats.ncaa.org player identifier for the home slot-5 on-floor player.
home_5_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-5 on-floor player.
away_1_player_idstringstats.ncaa.org player identifier for the away slot-1 on-floor player.
away_1_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-1 on-floor player.
away_2_player_idstringstats.ncaa.org player identifier for the away slot-2 on-floor player.
away_2_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-2 on-floor player.
away_3_player_idstringstats.ncaa.org player identifier for the away slot-3 on-floor player.
away_3_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-3 on-floor player.
away_4_player_idstringstats.ncaa.org player identifier for the away slot-4 on-floor player.
away_4_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-4 on-floor player.
away_5_player_idstringstats.ncaa.org player identifier for the away slot-5 on-floor player.
away_5_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-5 on-floor player.
espn_game_idstringESPN game id (NA for bart-only rows).
is_fastbreakbooleanFlag marking the shot as a fast-break attempt, from the stats.ncaa.org play text.
is_from_turnoverbooleanFlag marking an attempt generated off an opponent turnover.
is_paintbooleanFlag marking the shot as attempted in the paint.
is_second_chancebooleanFlag marking a second-chance attempt following an offensive rebound.
assist_playerstringName of the player credited with the assist on a made shot, when present.
ft_numbernumber | bigintWhich free throw of the trip this attempt is (1 of 2, 2 of 2, etc.).
ft_attemptsnumber | bigintTotal free throws in the trip this attempt belongs to.
foul_classstringParsed category of the foul event (e.g. personal, offensive).
is_shooting_foulbooleanFlag marking the foul as a shooting foul.
is_looseball_foulbooleanFlag marking the foul as a loose-ball foul.
is_one_and_onebooleanFlag marking a bonus one-and-one free-throw trip.
is_flagrantbooleanFlag marking the foul as flagrant.
foul_tech_classstringParsed technical-foul class for technical foul events, when present.
ft_awardednumber | bigintNumber of free throws awarded by the foul.
turnover_typestringParsed turnover subtype (e.g. lost ball, bad pass, travel).
is_team_turnoverbooleanFlag marking a turnover charged to the team rather than an individual player.
timeout_typestringType of timeout called (e.g. full, 30-second, media).
challenge_outcomestringOutcome of a coach's challenge or video-review event, when present.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbSchedule​

Release: ncaa_wbb_schedule · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_schedule/ncaa_wbb_schedule_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbSchedule({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_schedule(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbScheduleRow (exported from the package root).

col_nametypedescription
contest_idstring
game_datestringGame date (YYYY-MM-DD).
homestringHome.
awaystringAway record.
home_scorenumber | bigintHome team score at the time of the play.
away_scorenumber | bigintAway team score at the time of the play.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbPlayerBox​

Release: ncaa_wbb_player_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_player_box/ncaa_wbb_player_box_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbPlayerBox({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_player_box(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbPlayerBoxRow (exported from the package root).

col_nametypedescription
game_datestringGame date (YYYY-MM-DD).
homestringHome.
awaystringAway record.
teamstringTeam-side label or team identifier.
playerstringPlayer name.
minsnumberMinutes played, derived from the lineup walk-forward through the play-by-play.
o_possnumberOffensive possessions the player was on the floor for.
ptsnumberPoints scored.
orbnumberOffensive rebounds.
drbnumberDefensive rebounds.
astnumberAssists.
stlnumberSteals.
blknumberBlocks.
tovnumberTurnovers.
pfnumberPersonal fouls.
ts_pctnumberTrue shooting percentage (0-1).
efg_pctnumberEffective field-goal percentage, weighting made threes at 1.5.
fgmnumberField goals made.
fganumberField goal attempts.
fg_pctnumberField goal percentage (0-1).
tpmnumberThree-point field goals made.
tpanumberThree-point field goals attempted.
tp_pctnumberThree-point field-goal percentage.
ftmnumberFree throws made.
ftanumberFree throw attempts.
ft_pctnumberFree throw percentage (0-1).
rimmnumberRim shots (dunks, layups, hooks, tip-ins) made.
rimanumberRim shots (dunks, layups, hooks, tip-ins) attempted.
rim_pctnumberField-goal percentage on rim attempts.
midmnumberMid-range (non-rim two-point) shots made.
midanumberMid-range (non-rim two-point) shots attempted.
mid_pctnumberField-goal percentage on mid-range attempts.
pbackmnumberPutbacks made — rim shots immediately following an offensive rebound.
pbackanumberPutbacks attempted — rim shots immediately following an offensive rebound.
pback_pctnumberField-goal percentage on putback attempts.
blk_rimnumberBlocks recorded against opponent rim attempts.
blk_midnumberBlocks recorded against opponent mid-range attempts.
blk_threenumberBlocks recorded against opponent three-point attempts.
pct_fga_transnumberShare of the player's field-goal attempts taken in transition.
pct_tpa_transnumberShare of the player's three-point attempts taken in transition.
pct_rima_transnumberShare of the player's rim attempts taken in transition.
pct_fgm_transnumberShare of the player's field-goal makes that came in transition.
pct_tpm_transnumberShare of the player's three-point makes that came in transition.
pct_rimm_transnumberShare of the player's rim makes that came in transition.
pct_fgm_astnumberShare of the player's made field goals that were assisted.
pct_tpm_astnumberShare of the player's made threes that were assisted.
pct_rimm_astnumberShare of the player's made rim shots that were assisted.
pts_transnumberPoints scored in transition possessions.
orb_transnumberOffensive rebounds in transition possessions.
drb_transnumberDefensive rebounds in transition possessions.
ast_transnumberAssists in transition possessions.
stl_transnumberSteals in transition possessions.
blk_transnumberBlocks in transition possessions.
tov_transnumberTurnovers in transition possessions.
ts_pct_transnumberTrue-shooting percentage in transition possessions.
efg_pct_transnumberEffective field-goal percentage in transition possessions.
fgm_transnumberField goals made in transition possessions.
fga_transnumberField goals attempted in transition possessions.
fg_pct_transnumberField-goal percentage in transition possessions.
tpm_transnumberThree-pointers made in transition possessions.
tpa_transnumberThree-pointers attempted in transition possessions.
tp_pct_transnumberThree-point percentage in transition possessions.
ftm_transnumberFree throws made in transition possessions.
fta_transnumberFree throws attempted in transition possessions.
ft_pct_transnumberFree-throw percentage in transition possessions.
rimm_transnumberRim shots made in transition possessions.
rima_transnumberRim shots attempted in transition possessions.
rim_pct_transnumberRim field-goal percentage in transition possessions.
midm_transnumberMid-range shots made in transition possessions.
mida_transnumberMid-range shots attempted in transition possessions.
mid_pct_transnumberMid-range field-goal percentage in transition possessions.
pts_halfnumberPoints scored in halfcourt possessions.
orb_halfnumberOffensive rebounds in halfcourt possessions.
drb_halfnumberDefensive rebounds in halfcourt possessions.
ast_halfnumberAssists in halfcourt possessions.
stl_halfnumberSteals in halfcourt possessions.
blk_halfnumberBlocks in halfcourt possessions.
tov_halfnumberTurnovers in halfcourt possessions.
ts_pct_halfnumberTrue-shooting percentage in halfcourt possessions.
efg_pct_halfnumberEffective field-goal percentage in halfcourt possessions.
fgm_halfnumberField goals made in halfcourt possessions.
fga_halfnumberField goals attempted in halfcourt possessions.
fg_pct_halfnumberField-goal percentage in halfcourt possessions.
tpm_halfnumberThree-pointers made in halfcourt possessions.
tpa_halfnumberThree-pointers attempted in halfcourt possessions.
tp_pct_halfnumberThree-point percentage in halfcourt possessions.
ftm_halfnumberFree throws made in halfcourt possessions.
fta_halfnumberFree throws attempted in halfcourt possessions.
ft_pct_halfnumberFree-throw percentage in halfcourt possessions.
rimm_halfnumberRim shots made in halfcourt possessions.
rima_halfnumberRim shots attempted in halfcourt possessions.
rim_pct_halfnumberRim field-goal percentage in halfcourt possessions.
midm_halfnumberMid-range shots made in halfcourt possessions.
mida_halfnumberMid-range shots attempted in halfcourt possessions.
mid_pct_halfnumberMid-range field-goal percentage in halfcourt possessions.
pts_astnumberPoints from the player's assisted field-goal makes.
fgm_astnumberAssisted field-goal makes.
tpm_astnumberAssisted three-point makes.
rimm_astnumberAssisted rim makes.
midm_astnumberAssisted mid-range makes.
pts_unastnumberPoints from the player's unassisted field-goal makes.
efg_pct_unastnumberEffective field-goal percentage in the unassisted split (makes for which no assist was credited).
fgm_unastnumberField goals made in the unassisted split (makes for which no assist was credited).
fga_unastnumberField goals attempted in the unassisted split (makes for which no assist was credited).
fg_pct_unastnumberField-goal percentage in the unassisted split (makes for which no assist was credited).
tpm_unastnumberThree-pointers made in the unassisted split (makes for which no assist was credited).
tpa_unastnumberThree-pointers attempted in the unassisted split (makes for which no assist was credited).
tp_pct_unastnumberThree-point percentage in the unassisted split (makes for which no assist was credited).
rimm_unastnumberRim shots made in the unassisted split (makes for which no assist was credited).
rima_unastnumberRim shots attempted in the unassisted split (makes for which no assist was credited).
rim_pct_unastnumberRim field-goal percentage in the unassisted split (makes for which no assist was credited).
midm_unastnumberMid-range shots made in the unassisted split (makes for which no assist was credited).
mida_unastnumberMid-range shots attempted in the unassisted split (makes for which no assist was credited).
mid_pct_unastnumberMid-range field-goal percentage in the unassisted split (makes for which no assist was credited).
contest_idstring
home_ncaa_team_idstringstats.ncaa.org team identifier for the home team.
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_ncaa_team_idstringstats.ncaa.org team identifier for the away team.
away_espn_team_idstringESPN away team id (NA for bart-only rows).
team_ncaa_team_idstringstats.ncaa.org team identifier of the player's team.
team_espn_team_idstringESPN team identifier of the player's team, via the NCAA-to-ESPN crosswalk.
player_idstringUnique player identifier.
clean_namestringNormalized (diacritics- and punctuation-cleaned) player name used to join across the NCAA datasets.
espn_game_idstringESPN game id (NA for bart-only rows).
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbTeamBox​

Release: ncaa_wbb_team_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_team_box/ncaa_wbb_team_box_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbTeamBox({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_team_box(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbTeamBoxRow (exported from the package root).

col_nametypedescription
homestringHome.
awaystringAway record.
teamstringTeam-side label or team identifier.
minsnumberMinutes covered by the team's tracked lineups in the game.
o_minsnumberMinutes spent on tracked offensive possessions.
d_minsnumberMinutes spent on tracked defensive possessions.
o_possnumberOffensive possessions.
d_possnumberDefensive possessions.
ortgnumberOffensive rating — points scored per 100 possessions.
drtgnumberDefensive rating — points allowed per 100 possessions.
netrtgnumberNet rating — offensive rating minus defensive rating.
ptsnumberPoints scored.
d_ptsnumberPoints allowed.
fganumberField goal attempts.
d_fganumberOpponent field-goal attempts.
fgmnumberField goals made.
d_fgmnumberOpponent field goals made.
tpanumberThree-point attempts.
d_tpanumberOpponent three-point attempts.
tpmnumberThree-pointers made.
d_tpmnumberOpponent three-pointers made.
ftanumberFree throw attempts.
d_ftanumberOpponent free-throw attempts.
ftmnumberFree throws made.
d_ftmnumberOpponent free throws made.
rimanumberRim shots (dunks, layups, hooks, tip-ins) attempted.
d_rimanumberOpponent rim shots attempted.
rimmnumberRim shots made.
d_rimmnumberOpponent rim shots made.
orbnumberOffensive rebounds.
d_orbnumberOpponent offensive rebounds.
drbnumberDefensive rebounds.
d_drbnumberOpponent defensive rebounds.
blknumberBlocks.
d_blknumberOpponent blocks (own shots blocked).
tonumberTo.
d_tonumberOpponent turnovers forced.
astnumberAssists.
d_astnumberOpponent assists allowed.
e_possnumberEstimated possessions — the average of the team's and the opponent's raw possession counts.
fg_pctnumberField goal percentage (0-1).
d_fg_pctnumberOpponent field-goal percentage.
tppnumberThree-point percentage.
d_tppnumberOpponent three-point percentage.
ftpnumberFree-throw percentage.
d_ftpnumberOpponent free-throw percentage.
efg_pctnumberEffective field-goal percentage, weighting made threes at 1.5.
d_efg_pctnumberOpponent effective field-goal percentage.
ts_pctnumberTrue shooting percentage (0-1).
d_ts_pctnumberOpponent true-shooting percentage.
rim_pctnumberField-goal percentage on rim attempts.
d_rim_pctnumberOpponent field-goal percentage on rim attempts.
mid_pctnumberField-goal percentage on mid-range attempts.
d_mid_pctnumberOpponent field-goal percentage on mid-range attempts.
tp_ratenumberThree-point attempts as a share of field-goal attempts.
d_tp_ratenumberOpponent three-point attempts as a share of their field-goal attempts.
rim_ratenumberRim attempts as a share of field-goal attempts.
d_rim_ratenumberOpponent rim attempts as a share of their field-goal attempts.
mid_ratenumberMid-range attempts as a share of field-goal attempts.
d_mid_ratenumberOpponent mid-range attempts as a share of their field-goal attempts.
ft_ratenumberFt rate.
d_ft_ratenumberOpponent free-throw attempts relative to their field-goal attempts.
ast_ratenumberShare of the team's made field goals that were assisted.
d_ast_ratenumberShare of opponent made field goals that were assisted.
to_ratenumberTo rate.
d_to_ratenumberOpponent turnovers as a share of their possessions (forced-turnover rate).
blk_ratenumberShare of opponent two-point attempts the team blocked.
o_blk_ratenumberShare of the team's own two-point attempts blocked by the opponent.
orb_pctnumberOffensive rebound percentage.
drb_pctnumberDefensive rebound percentage.
time_per_possnumberAverage seconds per offensive possession.
d_time_per_possnumberAverage seconds per defensive possession.
contest_idstring
home_ncaa_team_idstringstats.ncaa.org team identifier for the home team.
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_ncaa_team_idstringstats.ncaa.org team identifier for the away team.
away_espn_team_idstringESPN away team id (NA for bart-only rows).
team_ncaa_team_idstringstats.ncaa.org team identifier of the team the row belongs to.
team_espn_team_idstringESPN team identifier of the team, via the NCAA-to-ESPN crosswalk.
espn_game_idstringESPN game id (NA for bart-only rows).
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbRosters​

Release: ncaa_wbb_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_rosters/ncaa_wbb_rosters_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbRosters({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbRostersRow (exported from the package root).

col_nametypedescription
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
teamstringTeam-side label or team identifier.
playerstringPlayer name.
gamesnumber | bigintGames played.

loadNcaaWbbTeamRosters​

Release: ncaa_wbb_team_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_team_rosters/ncaa_wbb_team_rosters_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbTeamRosters({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_team_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbTeamRostersRow (exported from the package root).

col_nametypedescription
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
teamstringTeam-side label or team identifier.
player_idstringUnique player identifier.
playerstringPlayer name.
clean_namestringNormalized (diacritics- and punctuation-cleaned) player name used to join across the NCAA datasets.
namestringDisplay name.
jerseystringJersey number worn by the player.
classstringCollege class / draft eligibility note.
positionstringListed roster position (G, F, C, etc.).
heightstringPlayer height (string e.g. '6-2' or inches).
ht_inchesnumber | bigintPlayer height converted to total inches from the stats.ncaa.org roster listing.
hometownstringPlayer hometown.
high_schoolstring
gpstringGames played.
gsstringGames started.

loadNcaaWbbTeamIds​

Release: ncaa_wbb_team_ids · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_team_ids/ncaa_wbb_team_ids_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbTeamIds({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_team_ids(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbTeamIdsRow (exported from the package root).

col_nametypedescription
teamstringTeam-side label or team identifier.
conferencestringFilter players or teams by conference.
idstringUnique play identification number
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbPossessions​

Release: ncaa_wbb_possessions · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_possessions/ncaa_wbb_possessions_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbPossessions({ seasons: 2024, columns: ['game_date', 'home', 'away', 'poss_num', 'poss_team'] });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_possessions(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbPossessionsRow (exported from the package root).

col_nametypedescription
game_datestringGame date (YYYY-MM-DD).
homestringHome.
awaystringAway record.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
poss_numnumber | bigintSequential possession number within the game.
poss_teamstringName of the team in possession.
home_1stringName of the home team's on-floor player in lineup slot 1 for the possession, from the substitution walk-forward.
home_2stringName of the home team's on-floor player in lineup slot 2 for the possession, from the substitution walk-forward.
home_3stringName of the home team's on-floor player in lineup slot 3 for the possession, from the substitution walk-forward.
home_4stringName of the home team's on-floor player in lineup slot 4 for the possession, from the substitution walk-forward.
home_5stringName of the home team's on-floor player in lineup slot 5 for the possession, from the substitution walk-forward.
away_1stringName of the away team's on-floor player in lineup slot 1 for the possession, from the substitution walk-forward.
away_2stringName of the away team's on-floor player in lineup slot 2 for the possession, from the substitution walk-forward.
away_3stringName of the away team's on-floor player in lineup slot 3 for the possession, from the substitution walk-forward.
away_4stringName of the away team's on-floor player in lineup slot 4 for the possession, from the substitution walk-forward.
away_5stringName of the away team's on-floor player in lineup slot 5 for the possession, from the substitution walk-forward.
home_scorenumber | bigintHome team score at the time of the play.
away_scorenumber | bigintAway team score at the time of the play.
ptsnumber | bigintPoints scored.
is_assistednumber | bigint1 when the possession's made field goal was assisted, else 0.
is_transitionnumber | bigint1 for transition possessions, else 0.
is_garbage_timenumber | bigint1 for possessions in garbage time under the score-margin and clock rule, else 0.
start_event_typestringEvent type that opened the possession (e.g., a defensive rebound or a made-basket inbound).
first_shot_timenumber | bigintClock time in seconds at the possession's first shot attempt, from the possession segmentation engine.
first_shot_typestringShot class of the possession's first attempt (rim, mid-range, or three).
last_event_timenumber | bigintClock time in seconds at the possession's final event.
last_event_typestringEvent type that ended the possession (e.g., a made shot, turnover, or defensive rebound).
contest_idstring
home_ncaa_team_idstringstats.ncaa.org team identifier for the home team.
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_ncaa_team_idstringstats.ncaa.org team identifier for the away team.
away_espn_team_idstringESPN away team id (NA for bart-only rows).
poss_team_ncaa_team_idstringstats.ncaa.org team identifier of the team in possession.
poss_team_espn_team_idstringESPN team identifier of the team in possession, via the NCAA-to-ESPN crosswalk.
home_1_player_idstringstats.ncaa.org player identifier for the home slot-1 on-floor player.
home_1_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-1 on-floor player.
home_2_player_idstringstats.ncaa.org player identifier for the home slot-2 on-floor player.
home_2_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-2 on-floor player.
home_3_player_idstringstats.ncaa.org player identifier for the home slot-3 on-floor player.
home_3_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-3 on-floor player.
home_4_player_idstringstats.ncaa.org player identifier for the home slot-4 on-floor player.
home_4_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-4 on-floor player.
home_5_player_idstringstats.ncaa.org player identifier for the home slot-5 on-floor player.
home_5_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the home slot-5 on-floor player.
away_1_player_idstringstats.ncaa.org player identifier for the away slot-1 on-floor player.
away_1_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-1 on-floor player.
away_2_player_idstringstats.ncaa.org player identifier for the away slot-2 on-floor player.
away_2_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-2 on-floor player.
away_3_player_idstringstats.ncaa.org player identifier for the away slot-3 on-floor player.
away_3_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-3 on-floor player.
away_4_player_idstringstats.ncaa.org player identifier for the away slot-4 on-floor player.
away_4_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-4 on-floor player.
away_5_player_idstringstats.ncaa.org player identifier for the away slot-5 on-floor player.
away_5_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the away slot-5 on-floor player.
espn_game_idstringESPN game id (NA for bart-only rows).
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbLineups​

Release: ncaa_wbb_lineups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_lineups/ncaa_wbb_lineups_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbLineups({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_lineups(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbLineupsRow (exported from the package root).

col_nametypedescription
lineup_keystringSorted player-code key identifying the five-player unit on the floor (hoop-explorer convention).
datestringDate in YYYY-MM-DD format.
location_typestringWhether the lineup's team was the Home or Away side in the game.
teamstringTeam-side label or team identifier.
team_yearnumber | bigintSeason year of the team-season the lineup row belongs to.
opponentstringOpponent.
lineup_idstringSorted-name identifier of the five-player lineup, joined from the on-floor player names.
start_minnumberGame minute at which the stint began.
end_minnumberGame minute at which the stint ended.
duration_minsnumberLength of the stint in minutes.
player_1stringName of the first player (in sorted order) of the five-player lineup.
player_2stringName of the second player (in sorted order) of the five-player lineup.
player_3stringName of the third player (in sorted order) of the five-player lineup.
player_4stringName of the fourth player (in sorted order) of the five-player lineup.
player_5stringName of the fifth player (in sorted order) of the five-player lineup.
players_instringDelimited names of the players substituted in at the start of the stint.
players_outstringDelimited names of the players substituted out at the end of the stint.
start_scorednumber | bigintTeam points scored at the moment the stint began.
start_allowednumber | bigintPoints allowed at the moment the stint began.
end_scorednumber | bigintTeam points scored at the moment the stint ended.
end_allowednumber | bigintPoints allowed at the moment the stint ended.
start_diffnumber | bigintScore margin (scored minus allowed) when the stint began.
end_diffnumber | bigintScore margin (scored minus allowed) when the stint ended.
player_count_errorunknownFlag marking stints where the reconciled on-floor count was not exactly five players (all-null when clean).
possnumber | bigintPoss.
ptsnumber | bigintPoints scored.
plus_minusnumber | bigintPlus/minus point differential while on court.
fganumber | bigintField goal attempts.
fgmnumber | bigintField goals made.
rimanumber | bigintRim shots (dunks, layups, hooks, tip-ins) attempted by the lineup during the stint.
rimmnumber | bigintRim shots made by the lineup during the stint.
rim_astnumber | bigintAssisted rim makes by the lineup during the stint.
midanumber | bigintMid-range shots attempted by the lineup during the stint.
midmnumber | bigintMid-range shots made by the lineup during the stint.
mid_astnumber | bigintAssisted mid-range makes by the lineup during the stint.
fg2anumber | bigintTwo-point field goals attempted by the lineup during the stint.
fg2mnumber | bigintTwo-point field goals made by the lineup during the stint.
tpanumber | bigintThree-pointers attempted by the lineup during the stint.
tpmnumber | bigintThree-pointers made by the lineup during the stint.
tp_astnumber | bigintAssisted three-point makes by the lineup during the stint.
ftanumber | bigintFree throw attempts.
ftmnumber | bigintFree throws made.
orbnumber | bigintOffensive rebounds by the lineup during the stint.
drbnumber | bigintDefensive rebounds by the lineup during the stint.
tonumber | bigintTo.
stlnumber | bigintSteals.
blknumber | bigintBlocks.
astnumber | bigintAssists.
foulnumber | bigintFouls committed by the lineup during the stint.
opp_possnumber | bigintOpponent possessions while the lineup was on the floor during the stint.
opp_ptsnumber | bigintOpponent points.
opp_plus_minusnumber | bigintOpponent scoring margin while the lineup was on the floor during the stint.
opp_fganumber | bigintOpponent field-goal attempts while the lineup was on the floor during the stint.
opp_fgmnumber | bigintOpponent field goals made while the lineup was on the floor during the stint.
opp_rimanumber | bigintOpponent rim shots attempted while the lineup was on the floor during the stint.
opp_rimmnumber | bigintOpponent rim shots made while the lineup was on the floor during the stint.
opp_rim_astnumber | bigintOpponent assisted rim makes while the lineup was on the floor during the stint.
opp_midanumber | bigintOpponent mid-range shots attempted while the lineup was on the floor during the stint.
opp_midmnumber | bigintOpponent mid-range shots made while the lineup was on the floor during the stint.
opp_mid_astnumber | bigintOpponent assisted mid-range makes while the lineup was on the floor during the stint.
opp_fg2anumber | bigintOpponent two-point attempts while the lineup was on the floor during the stint.
opp_fg2mnumber | bigintOpponent two-point makes while the lineup was on the floor during the stint.
opp_tpanumber | bigintOpponent three-point attempts while the lineup was on the floor during the stint.
opp_tpmnumber | bigintOpponent three-point makes while the lineup was on the floor during the stint.
opp_tp_astnumber | bigintOpponent assisted three-point makes while the lineup was on the floor during the stint.
opp_ftanumber | bigintOpponent free-throw attempts while the lineup was on the floor during the stint.
opp_ftmnumber | bigintOpponent free throws made while the lineup was on the floor during the stint.
opp_orbnumber | bigintOpponent offensive rebounds while the lineup was on the floor during the stint.
opp_drbnumber | bigintOpponent defensive rebounds while the lineup was on the floor during the stint.
opp_tonumber | bigintOpponent turnovers while the lineup was on the floor during the stint.
opp_stlnumber | bigintOpponent steals while the lineup was on the floor during the stint.
opp_blknumber | bigintOpponent blocks while the lineup was on the floor during the stint.
opp_astnumber | bigintOpponent assists while the lineup was on the floor during the stint.
opp_foulnumber | bigintOpponent fouls committed while the lineup was on the floor during the stint.
stint_numnumber | bigintSequential on-floor stint number for the lineup within the game.
contest_idstring
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadNcaaWbbMatchupStints​

Release: ncaa_wbb_matchup_stints · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_matchup_stints/ncaa_wbb_matchup_stints_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbMatchupStints({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_matchup_stints(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbMatchupStintsRow (exported from the package root).

col_nametypedescription
contest_idstring
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_datestringGame date (YYYY-MM-DD).
homestringHome.
awaystringAway record.
game_stint_numnumber | bigintSequential stint number within the game, incremented at every substitution by either team.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
start_secondsnumber | bigintElapsed game seconds at which the stint began.
end_secondsnumber | bigintElapsed game seconds at which the stint ended.
duration_secondsnumber | bigintDuration of the lineup stint in seconds.
matchup_keystringCombined home-plus-away lineup key identifying the ten-player matchup on the floor.
home_lineup_keystringSorted player-code key for the home five on the floor.
away_lineup_keystringSorted player-code key for the away five on the floor.
home_lineupstringDelimited names of the home five on the floor during the stint.
away_lineupstringDelimited names of the away five on the floor during the stint.
end_home_scorenumber | bigintHome team score when the stint ended.
end_away_scorenumber | bigintAway team score when the stint ended.
n_eventsnumber | bigintNumber of play-by-play events falling within the stint.
n_possessionsnumber | bigintNumber of possessions falling within the stint.
start_home_scorenumber | bigintHome team score when the stint began.
start_away_scorenumber | bigintAway team score when the stint began.
home_ptsnumber | bigintPoints scored by the home team during the stint.
away_ptsnumber | bigintPoints scored by the away team during the stint.
home_1stringName of the home team's on-floor player in lineup slot 1 for the stint.
home_2stringName of the home team's on-floor player in lineup slot 2 for the stint.
home_3stringName of the home team's on-floor player in lineup slot 3 for the stint.
home_4stringName of the home team's on-floor player in lineup slot 4 for the stint.
home_5stringName of the home team's on-floor player in lineup slot 5 for the stint.
away_1stringName of the away team's on-floor player in lineup slot 1 for the stint.
away_2stringName of the away team's on-floor player in lineup slot 2 for the stint.
away_3stringName of the away team's on-floor player in lineup slot 3 for the stint.
away_4stringName of the away team's on-floor player in lineup slot 4 for the stint.
away_5stringName of the away team's on-floor player in lineup slot 5 for the stint.

loadNcaaWbbShots​

Release: ncaa_wbb_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_shots/ncaa_wbb_shots_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2019)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbShots({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_shots(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbShotsRow (exported from the package root).

col_nametypedescription
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
shooter_idstringUnique identifier for shooter.
shot_xnumberCourt x-coordinate of the attempt in feet, decoded from the stats.ncaa.org shot-chart map.
shot_ynumberCourt y-coordinate of the attempt in feet, decoded from the stats.ncaa.org shot-chart map.
dist_ftnumberShot distance from the basket in feet.
shot_zonestringLabeled zone of the attempt (rim, mid-range, or three-point).
shot_typestringShot type label (e.g. 'Jump Shot', 'Layup').
madebooleanWhether the shot was made.
point_valuenumber | bigintPoint value of the attempt (2 or 3).
periodunknownPeriod of the game (1-4 quarters; 5+ for OT).
sec_leftunknownSeconds remaining in the period when the shot was taken (all-null in current captures).
sourcestring
contest_idstring
ncaa_team_idstringstats.ncaa.org team identifier of the shooting team.
espn_team_idstringESPN team id (canonical key).
shooter_player_idstringstats.ncaa.org player identifier of the shooter.
shooter_clean_namestringNormalized (diacritics- and punctuation-cleaned) name of the shooter.
espn_game_idstringESPN game id (NA for bart-only rows).

loadNcaaWbbRapmWithinTeam​

Release: ncaa_wbb_rapm_within_team · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_wbb_rapm_within_team/ncaa_wbb_rapm_within_team_{season}.parquet

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2010)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadNcaaWbbRapmWithinTeam({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_ncaa_wbb_rapm_within_team(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadNcaaWbbRapmWithinTeamRow (exported from the package root).

col_nametypedescription
teamstringTeam-side label or team identifier.
player_codestringShort unique-within-team player code generated from the player's name (hoop-explorer convention).
rapm_offnumberRidge-regressed offensive RAPM per 100 possessions, estimated relative to the player's own teammates.
rapm_defnumberRidge-regressed defensive RAPM per 100 possessions relative to teammates; positive means good defense.
team_off_possnumberTeam offensive possessions underlying the within-team fit.
num_playersnumber | bigintNumber of players in the team's RAPM design matrix.
rapm_netnumberNet RAPM — the sum of the offensive and defensive components, per 100 possessions.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
player_idstringUnique player identifier.
team_idstringUnique team identifier.
person_idstringUnique player identifier (V3 endpoints).

loadWbbGroups​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_groups.parquet

Coverage

One season-less file: one row per group lineage (the league, subdivisions, conferences, divisions) with the first and last season it had members. group_id is SDV's own id (e.g. wbb:big-east) and names a lineage: a rename that keeps continuity keeps the id, a new body gets a new one, and notes records each call. Seasons are the ENDING year (2025 = the 2024-25 season).

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbGroups();
// snake_case alias (py/R parity): sdv.wbb.load_wbb_groups(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbGroupsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idstringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
levelstringHierarchy level of the group: "league", "subdivision", "conference" or "division".
first_seasonnumberFirst season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
last_seasonnumberLast season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
notesstringBuilder notes on the group: the lineage decisions behind its group_id and any source caveats.

loadWbbGroupSeasons​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_group_seasons.parquet

Coverage

One season-less file: one row per group per season it existed, with its name, short name, abbreviation and parent group AS OF that season (never today's label applied to the past) and its member count. season is the ENDING year (2025 = the 2024-25 season).

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbGroupSeasons();
// snake_case alias (py/R parity): sdv.wbb.load_wbb_group_seasons(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbGroupSeasonsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idstringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
seasonnumberSeason the row describes (ENDING year: 2025 = the 2024-25 season).
levelstringHierarchy level of the group: "league", "subdivision", "conference" or "division".
namestringFull name of the group as of that season -- the label in use then, not today's name.
short_namestringShort display name of the group as of that season.
abbreviationstringAbbreviation of the group as of that season.
parent_group_idstringgroup_id one level up as of that season (division -> conference -> subdivision -> league); null at the top level or where no higher group applied that season.
n_teamsnumberNumber of member teams in the group that season.

loadWbbGroupAliases​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_group_aliases.parquet

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (espn, ncaa, sdv) uses for a group, each with the seasons it is valid for (valid_from / valid_to, inclusive; null = unbounded). Match a source's conference or division label here to reach group_id.

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbGroupAliases();
// snake_case alias (py/R parity): sdv.wbb.load_wbb_group_aliases(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbGroupAliasesRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idstringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
sourcestringSource that uses this label or id (in this table: espn, ncaa, sdv); "sdv" marks SDV's own labels.
source_idstringThe source's own id for the group (ESPN group id, NCAA conf_id, CFBD id, MLB division id) when it has one; null otherwise.
name_kindstringKind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
valuestringThe label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_fromnumberFirst season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded.
valid_tonumberLast season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded (still in use).

loadWbbTeamGroupSeasons​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_team_group_seasons_{season}.parquet

Coverage

One row per team per season: the SDV subdivision, conference and division group ids the team belonged to that season (null where a level does not apply), the team name as of that season, where the membership came from, and whether a second source agreed (null when only one source covers the season). team_id is a string: the ESPN team id; team_id_source names the id space. season is the ENDING year (2025 = the 2024-25 season); seasons 2002-2027.

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wbb.loadWbbTeamGroupSeasons({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wbb.load_wbb_team_group_seasons(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWbbTeamGroupSeasonsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wbb"); the prefix of every group_id in it.
seasonnumberSeason of the membership (ENDING year: 2025 = the 2024-25 season).
team_idstringTeam id as a string: the ESPN team id where ESPN covers the team, otherwise the league's own id; team_id_source says which.
team_id_sourcestringId space of team_id (in this table: espn).
team_namestringTeam name as of that season, not today's.
subdivision_idstringSDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level.
conference_idstringSDV group_id of the team's conference that season; null where the team had no conference (an independent, or a season played without conferences).
division_idstringSDV group_id of the team's division that season; null where the level does not apply.
sourcestringSource the membership was taken from -- the most reliable per-season source for that era.
sources_agreebooleanWhether a second source agreed on the membership; null when only one source covers the season.
notesstringBuilder notes on the team-season, such as a source disagreement or which of several listed memberships was kept.

Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/releases.yaml (vendored from sdv-py) — see How this library is built.