Skip to contents

Returns the per-category leaderboard for one (MBB season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Returns the per-category leaderboard for one (NBA season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Usage

espn_mbb_season_leaders(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

espn_nba_season_leaders(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent MBB season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Value

A hoopR_data tibble with one row per category and leader.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
category_namecharacterInternal category key (e.g. "pointsPerGame").
category_displaycharacterHuman-readable category name.
category_shortcharacterShort display name.
category_abbrevcharacterStat abbreviation (e.g. "PTS").
rankintegerRank within the category (1 = best).
athlete_idcharacterESPN athlete id.
team_idcharacterESPN team id.
display_valuecharacterDisplay-formatted value.
valuenumericNumeric leader value.
relcharacterComma-joined rel tags from ESPN.
athlete_refcharacter$ref URL to the leader's athlete.
team_refcharacter$ref URL to the leader's team.

A hoopR_data tibble with one row per category and leader.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
category_namecharacterInternal category key (e.g. "pointsPerGame").
category_displaycharacterHuman-readable category name.
category_shortcharacterShort display name.
category_abbrevcharacterStat abbreviation (e.g. "PTS").
rankintegerRank within the category (1 = best).
athlete_idcharacterESPN athlete id.
team_idcharacterESPN team id.
display_valuecharacterDisplay-formatted value.
valuenumericNumeric leader value.
relcharacterComma-joined rel tags from ESPN.
athlete_refcharacter$ref URL to the leader's athlete.
team_refcharacter$ref URL to the leader's team.

Details

Get ESPN MBB Season Leaders (Long Format)

Get ESPN NBA Season Leaders (Long Format)

See also

family_espn_mbb lists every function in this family.

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_season_leaders(season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season-Type Leaders ───────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:30 UTC
#> # A tibble: 350 × 15
#>    league       season season_type category_name category_display category_short
#>    <chr>         <int>       <int> <chr>         <chr>            <chr>         
#>  1 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  2 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  3 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  4 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  5 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  6 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  7 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  8 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#>  9 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#> 10 mens-colleg…   2025           2 pointsPerGame Points Per Game  PPG           
#> # ℹ 340 more rows
#> # ℹ 9 more variables: category_abbrev <chr>, rank <int>, athlete_id <chr>,
#> #   team_id <chr>, display_value <chr>, value <dbl>, rel <chr>,
#> #   athlete_ref <chr>, team_ref <chr>
# }
# \donttest{
  espn_nba_season_leaders(season = 2025)
#> ── ESPN NBA Season-Type Leaders ───────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:32 UTC
#> # A tibble: 800 × 15
#>    league season season_type category_name category_display category_short
#>    <chr>   <int>       <int> <chr>         <chr>            <chr>         
#>  1 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  2 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  3 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  4 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  5 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  6 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  7 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  8 nba      2025           2 pointsPerGame Points Per Game  PPG           
#>  9 nba      2025           2 pointsPerGame Points Per Game  PPG           
#> 10 nba      2025           2 pointsPerGame Points Per Game  PPG           
#> # ℹ 790 more rows
#> # ℹ 9 more variables: category_abbrev <chr>, rank <int>, athlete_id <chr>,
#> #   team_id <chr>, display_value <chr>, value <dbl>, rel <chr>,
#> #   athlete_ref <chr>, team_ref <chr>
# }