MBB dataset loaders — Team
load_mbb_team_boxscore
Release: espn_mens_college_basketball_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_team_boxscores/team_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
game_date | Date | Game date (YYYY-MM-DD). |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
team_id | Int32 | Unique team identifier. |
team_uid | String | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_location | String | Team city or location string. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
team_home_away | String | Team home away. |
team_score | Int32 | Team's score / final score. |
team_winner | Boolean | TRUE if the team won this game. |
assists | Int32 | Total assists. |
blocks | Int32 | Total blocks. |
defensive_rebounds | Int32 | Defensive rebounds. |
fast_break_points | String | Fast-break points scored. |
field_goal_pct | Float64 | Field goal percentage (0-1). |
field_goals_made | Int32 | Field goals made (2-pt + 3-pt). |
field_goals_attempted | Int32 | Field goal attempts (2-pt + 3-pt). |
flagrant_fouls | Int32 | Total flagrant fouls. |
fouls | Int32 | Personal fouls. |
free_throw_pct | Float64 | Free throw percentage (0-1). |
free_throws_made | Int32 | Free throws made. |
free_throws_attempted | Int32 | Free throw attempts. |
largest_lead | String | Largest lead during the game. |
offensive_rebounds | Int32 | Offensive rebounds. |
points_in_paint | String | Points scored in the paint. |
steals | Int32 | Total steals. |
team_turnovers | Int32 | Team turnovers (turnovers credited to the team rather than a player). |
technical_fouls | Int32 | Total technical fouls. |
three_point_field_goal_pct | Float64 | Three-point field goal percentage (0-1). |
three_point_field_goals_made | Int32 | Three-point field goals made. |
three_point_field_goals_attempted | Int32 | Three-point field goal attempts. |
total_rebounds | Int32 | Total rebounds. |
total_technical_fouls | Int32 | Total technical fouls (player + team). |
total_turnovers | Int32 | Total turnovers (player + team). |
turnover_points | String | Turnover points. |
turnovers | Int32 | Total turnovers. |
opponent_team_id | Int32 | Unique identifier for the opponent team. |
opponent_team_uid | String | Opponent team uid. |
opponent_team_slug | String | Opponent team slug. |
opponent_team_location | String | Opponent team city / location. |
opponent_team_name | String | Opponent team display name. |
opponent_team_abbreviation | String | Opponent team abbreviation. |
opponent_team_display_name | String | Opponent team full display name. |
opponent_team_short_display_name | String | Opponent team short display name. |
opponent_team_color | String | Opponent team primary color (hex). |
opponent_team_alternate_color | String | Opponent team alternate color (hex). |
opponent_team_logo | String | Opponent team logo URL. |
opponent_team_score | Int32 | Opponent team's score. |
lead_changes | String | Lead changes. |
lead_percentage | String | Share of game time the team held the lead, as reported in ESPN's team boxscore. |
load_mbb_team_boxscore(seasons=2024)
load_mbb_team_season_stats
Release: espn_mens_college_basketball_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_team_season_stats/team_season_stats_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
category | String | Category label. |
stat_label | String | Human-readable label of the statistic (e.g. 'At bats'). |
stat_name | String | Stat key. |
stat_display_name | String | Stat display name. |
stat_description | String | ESPN's prose glossary definition of the statistic named in stat_name, for example defining field goal percentage as the ratio of field goals made to field goals attempted. |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_mbb_team_season_stats(seasons=2025)
load_mbb_team_crosswalk
Release: mbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_crosswalk/mbb_team_crosswalk_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
espn_team_id | Int32 | ESPN team id (canonical key). |
espn_abbreviation | String | ESPN abbreviation. |
espn_display_name | String | ESPN display name (school + mascot). |
espn_short_name | String | ESPN short name. |
espn_location | String | ESPN school/location only. |
espn_mascot | String | ESPN mascot/nickname. |
espn_conference | String | ESPN conference name. |
fox_team_id | String | Fox Bifrost team id (NA if unmatched). |
fox_team_name | String | Fox team name (NA if unmatched). |
fox_section | String | Fox conference/section label (NA if unmatched). |
bart_team | String | Torvik team name (NA if unmatched). |
bart_conf | String | Torvik conference abbreviation (NA if unmatched). |
kp_team | String | KenPom team name (NA if unmatched). |
kp_conf | String | KenPom conference abbreviation (NA if unmatched). |
yahoo_team_id | String | Yahoo team id (NA placeholder). |
yahoo_team_name | String | Yahoo team name (NA placeholder). |
fox_match_confidence | Float64 | 1 for matched, NA for unmatched. |
bart_match_confidence | Float64 | 1 for matched, NA for unmatched. |
kp_match_confidence | Float64 | 1 for matched, NA for unmatched. |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
load_mbb_team_crosswalk(seasons=2026)
load_mbb_team_group_seasons
Release: mbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/mbb_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.
Returns
| col_name | type | description |
|---|---|---|
league | String | League code of the table ("mbb"); the prefix of every group_id in it. |
season | Int32 | Season of the membership (ENDING year: 2025 = the 2024-25 season). |
team_id | String | Team 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_source | String | Id space of team_id (in this table: espn). |
team_name | String | Team name as of that season, not today's. |
subdivision_id | String | SDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level. |
conference_id | String | SDV 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_id | String | SDV group_id of the team's division that season; null where the level does not apply. |
source | String | Source the membership was taken from -- the most reliable per-season source for that era. |
sources_agree | Boolean | Whether a second source agreed on the membership; null when only one source covers the season. |
notes | String | Builder notes on the team-season, such as a source disagreement or which of several listed memberships was kept. |
load_mbb_team_group_seasons(seasons=2024)