NBA dataset loaders — Team
load_nba_team_boxscore
Release: espn_nba_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_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 | Percentage of the game the team held the lead, from ESPN's team box score stats. |
load_nba_team_boxscore(seasons=2024)
load_nba_team_season_stats
Release: espn_nba_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_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 | |
stat_name | String | Stat key. |
stat_display_name | String | Stat display name. |
stat_description | String | ESPN's prose definition of the team statistic on this row, for example the average number of assists a team records per turnover. |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_nba_team_season_stats(seasons=2025)
load_nba_team_crosswalk
Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_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. |
nba_team_id | String | NBA Stats team id side of the ESPN-to-NBA team crosswalk. |
nba_team_abbreviation | String | Team abbreviation as listed by the NBA Stats API. |
nba_team_name | String | Full NBA team name from the NBA Stats API, city followed by nickname (e.g. 'Boston Celtics'). |
nba_team_city | String | Team city as listed by the NBA Stats API. |
nba_team_slug | String | URL-friendly slug for the team's name on NBA Stats. |
nba_conference | String | Team's conference as listed by the NBA Stats API. |
nba_division | String | Team's division as listed by the NBA Stats API. |
fox_team_id | String | Fox Bifrost team id (NA if unmatched). |
fox_team_name | String | Fox team name (NA if unmatched). |
yahoo_team_id | String | Yahoo Sports team id, nba.t.<espn_team_id> (Yahoo's NBA ids equal ESPN's), from the 2014 season on; null for earlier seasons. |
yahoo_team_abbreviation | String | Yahoo abbreviation (NA placeholder). |
yahoo_team_name | String | Yahoo team name (NA placeholder). |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
match_confidence | Float64 | Jaro-Winkler score or 1 for exact (NA if none). |
load_nba_team_crosswalk(seasons=2026)
load_nba_team_group_seasons
Release: nba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_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 1971-2027.
Returns
| col_name | type | description |
|---|---|---|
league | String | League code of the table ("nba"); 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_nba_team_group_seasons(seasons=2024)