Skip to contents

Returns the team's depth chart in long format, one row per (position x rank x athlete). NBA-only at ESPN's core-v2.

Usage

espn_nba_team_depthchart(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier.

season

Season year. Defaults to most recent NBA season.

...

Additional arguments; currently unused.

Value

A hoopR_data tibble with one row per athlete depth entry.

col_nametypesdescription
leaguecharacterLeague slug.
team_idcharacterESPN team id.
seasonintegerSeason year.
depthchart_idcharacterDepth chart id (typically "1").
depthchart_namecharacterDepth chart name.
positioncharacterPosition code (pg/sg/sf/pf/c).
rankintegerDepth rank (1 = starter).
athlete_idcharacterESPN athlete id.
athlete_refcharacter$ref URL to athlete-in-season.
position_refcharacter$ref URL to position resource.

Details

Get ESPN NBA Team Depth Chart (Long Format)

See also

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_team_depthchart(team_id = 13, season = 2025)
#> ── ESPN NBA Team Depth Chart ──────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:54 UTC
#> # A tibble: 30 × 10
#>    league team_id season depthchart_id depthchart_name position  rank athlete_id
#>    <chr>  <chr>    <int> <chr>         <chr>           <chr>    <int> <chr>     
#>  1 nba    13        2025 1             Depth Chart     pg           1 3945274   
#>  2 nba    13        2025 1             Depth Chart     pg           2 3137259   
#>  3 nba    13        2025 1             Depth Chart     pg           3 2990992   
#>  4 nba    13        2025 1             Depth Chart     pg           4 4683774   
#>  5 nba    13        2025 1             Depth Chart     pg           5 4066457   
#>  6 nba    13        2025 1             Depth Chart     pg           6 4683686   
#>  7 nba    13        2025 1             Depth Chart     sg           1 4066457   
#>  8 nba    13        2025 1             Depth Chart     sg           2 2990992   
#>  9 nba    13        2025 1             Depth Chart     sg           3 4897943   
#> 10 nba    13        2025 1             Depth Chart     sg           4 4683774   
#> # ℹ 20 more rows
#> # ℹ 2 more variables: athlete_ref <chr>, position_ref <chr>
# }