Skip to contents

Loads a pre-built per-season NBA player crosswalk that maps ESPN athlete identifiers to NBA.com player identifiers. The files are versioned .rds snapshots stored in the nba_crosswalk release of the sportsdataverse-data repository.

Usage

load_nba_player_crosswalk(seasons = most_recent_nba_season())

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002; default: most_recent_nba_season())

Value

Returns a tibble of class hoopR_data with one row per NBA player per season. Columns include at minimum season, espn_athlete_id, and nba_player_id.

Examples

# \donttest{
load_nba_player_crosswalk(seasons = most_recent_nba_season())
#> ── NBA player crosswalk (ESPN / NBA Stats / Fox) ──────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-06-13 04:57:47 UTC
#> # A tibble: 537 × 21
#>    season espn_team_id team_abbreviation player_name             espn_athlete_id
#>     <int>        <int> <chr>             <chr>                   <chr>          
#>  1   2026            1 ATL               nickeil alexander walk… 4278039        
#>  2   2026            1 ATL               tony bradley            4065673        
#>  3   2026            1 ATL               dyson daniels           4869342        
#>  4   2026            1 ATL               rayj dennis             4431941        
#>  5   2026            1 ATL               keshon gilbert          4585618        
#>  6   2026            1 ATL               mouhamed gueye          4712863        
#>  7   2026            1 ATL               buddy hield             2990984        
#>  8   2026            1 ATL               caleb houstan           4433623        
#>  9   2026            1 ATL               jalen johnson           4701230        
#> 10   2026            1 ATL               corey kispert           4280151        
#> # ℹ 527 more rows
#> # ℹ 16 more variables: espn_full_name <chr>, espn_jersey <chr>,
#> #   espn_position <chr>, nba_player_id <chr>, nba_player_name <chr>,
#> #   nba_jersey_num <chr>, nba_position <chr>, fox_athlete_id <chr>,
#> #   fox_player <chr>, fox_jersey <chr>, fox_position_group <chr>,
#> #   yahoo_player_id <chr>, yahoo_player_name <chr>, match_method <chr>,
#> #   match_confidence <dbl>, match_keys <chr>
# }