Get ESPN NHL League Leaders
Usage
espn_nhl_leaders(
category = "offensive",
season = most_recent_nhl_season(),
season_type = 2L,
limit = 50L,
page = 1L,
...
)Arguments
- category
Stat category to display. For NHL one of
"offensive","defensive","general","penalties", orNULLfor all categories. Defaults to"offensive".- season
Season end-year (e.g.
2025). Defaults tomost_recent_nhl_season(). ESPN's NHLstatistics/byathleteendpoint currently ignores this parameter and always returns the current/most-recent season. The argument is accepted for forward-compatibility but does not filter upstream. The returnedseasonandseason_typecolumns reflect the season ESPN actually served, not this value.- season_type
Season type code (1 = pre, 2 = regular, 3 = post). Defaults to
2. ESPN's NHLstatistics/byathleteendpoint currently ignores this parameter. The returnedseason_typecolumn reflects the type ESPN actually served.- limit
Athletes per page (default
50).- page
Page number (default
1).- ...
Reserved for forward compatibility.
Value
A fastRhockey_data tibble with one row per athlete:
| col_name | types | description |
| season | integer | Season end-year ESPN actually served (from currentSeason$year). |
| season_type | integer | Season type id ESPN actually served (from currentSeason$type$id). |
| requested_season_year | integer | Season year from requestedSeason (mirrors season). |
| page | integer | Current page. |
| pagination_count | integer | Total athlete count. |
| pagination_limit | integer | Athletes per page. |
| pagination_pages | integer | Total page count. |
| league_id | character | ESPN league identifier. |
| league_name | character | League name. |
| league_abbreviation | character | League abbreviation. |
| athlete_id | character | ESPN athlete identifier. |
| athlete_display_name | character | Player display name. |
| athlete_short_name | character | Player short name. |
| athlete_slug | character | Player URL slug. |
| athlete_position | character | Position abbreviation. |
| athlete_jersey | character | Jersey number. |
| athlete_team_id | character | ESPN team identifier. |
| athlete_team_name | character | Team name. |
| athlete_team_short_name | character | Team short name. |
| athlete_team_logo | character | Team logo URL. |
| headshot_href | character | Player headshot URL. |
| debut_year | integer | Debut year. |
| age | integer | Player age. |
| offensive_goals | character | Goals (offensive category). |
| offensive_assists | character | Assists. |
| offensive_points | character | Points. |
| offensive_power_play_goals | character | Power-play goals. |
| offensive_shots_total | character | Shots on goal. |
| offensive_shooting_pct | character | Shooting percentage. |
| offensive_game_winning_goals | character | Game-winning goals. |
| offensive_rank_points | character | Rank by points. |
See also
Other ESPN NHL Functions:
espn_nhl_athletes_index(),
espn_nhl_award(),
espn_nhl_awards(),
espn_nhl_calendar(),
espn_nhl_calendar_offseason(),
espn_nhl_calendar_ondays(),
espn_nhl_calendar_postseason(),
espn_nhl_calendar_regular_season(),
espn_nhl_coach(),
espn_nhl_coach_record(),
espn_nhl_coach_season(),
espn_nhl_coaches(),
espn_nhl_conferences(),
espn_nhl_countries(),
espn_nhl_draft(),
espn_nhl_franchise(),
espn_nhl_franchises(),
espn_nhl_game(),
espn_nhl_game_all(),
espn_nhl_game_broadcasts(),
espn_nhl_game_competition(),
espn_nhl_game_leaders(),
espn_nhl_game_odds(),
espn_nhl_game_official_detail(),
espn_nhl_game_officials(),
espn_nhl_game_play(),
espn_nhl_game_play_personnel(),
espn_nhl_game_plays(),
espn_nhl_game_powerindex(),
espn_nhl_game_predictor(),
espn_nhl_game_probabilities(),
espn_nhl_game_propbets(),
espn_nhl_game_scoringplays(),
espn_nhl_game_situation(),
espn_nhl_game_status(),
espn_nhl_game_team(),
espn_nhl_game_team_leaders(),
espn_nhl_game_team_linescores(),
espn_nhl_game_team_record(),
espn_nhl_game_team_roster(),
espn_nhl_game_team_statistics(),
espn_nhl_game_teams(),
espn_nhl_games(),
espn_nhl_injuries(),
espn_nhl_leaders_core(),
espn_nhl_league_notes(),
espn_nhl_league_root(),
espn_nhl_news(),
espn_nhl_pbp(),
espn_nhl_player_awards(),
espn_nhl_player_bio(),
espn_nhl_player_box(),
espn_nhl_player_career_stats(),
espn_nhl_player_contracts(),
espn_nhl_player_core(),
espn_nhl_player_eventlog(),
espn_nhl_player_gamelog(),
espn_nhl_player_info(),
espn_nhl_player_injuries(),
espn_nhl_player_news(),
espn_nhl_player_notes(),
espn_nhl_player_overview(),
espn_nhl_player_records(),
espn_nhl_player_seasons(),
espn_nhl_player_splits(),
espn_nhl_player_statistics(),
espn_nhl_player_statisticslog(),
espn_nhl_player_stats_v3(),
espn_nhl_player_vs_player(),
espn_nhl_players_index(),
espn_nhl_position(),
espn_nhl_positions(),
espn_nhl_providers(),
espn_nhl_schedule(),
espn_nhl_scoreboard(),
espn_nhl_season_athletes(),
espn_nhl_season_awards(),
espn_nhl_season_coaches(),
espn_nhl_season_draft(),
espn_nhl_season_draft_round_picks(),
espn_nhl_season_freeagents(),
espn_nhl_season_futures(),
espn_nhl_season_group(),
espn_nhl_season_group_children(),
espn_nhl_season_group_teams(),
espn_nhl_season_groups(),
espn_nhl_season_info(),
espn_nhl_season_players(),
espn_nhl_season_pointer(),
espn_nhl_season_powerindex(),
espn_nhl_season_powerindex_leaders(),
espn_nhl_season_team(),
espn_nhl_season_teams(),
espn_nhl_season_type(),
espn_nhl_season_type_corrections(),
espn_nhl_season_type_leaders(),
espn_nhl_season_types(),
espn_nhl_season_week(),
espn_nhl_season_week_games(),
espn_nhl_season_weeks(),
espn_nhl_seasons(),
espn_nhl_standings(),
espn_nhl_standings_core(),
espn_nhl_statistics_league(),
espn_nhl_summary(),
espn_nhl_talentpicks(),
espn_nhl_team(),
espn_nhl_team_box(),
espn_nhl_team_core(),
espn_nhl_team_depthcharts(),
espn_nhl_team_history(),
espn_nhl_team_injuries(),
espn_nhl_team_leaders(),
espn_nhl_team_news(),
espn_nhl_team_record(),
espn_nhl_team_roster(),
espn_nhl_team_schedule(),
espn_nhl_team_transactions(),
espn_nhl_teams_core(),
espn_nhl_teams_site(),
espn_nhl_tournaments(),
espn_nhl_transactions(),
espn_nhl_venue(),
espn_nhl_venues()
Examples
# \donttest{
try(espn_nhl_leaders(category = "offensive", limit = 25))
#> ── NHL Leaders data from ESPN.com ───────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-12 14:17:42 UTC
#> # A tibble: 25 × 51
#> season season_type requested_season_year page pagination_count
#> <int> <int> <int> <int> <int>
#> 1 2026 3 2026 1 371
#> 2 2026 3 2026 1 371
#> 3 2026 3 2026 1 371
#> 4 2026 3 2026 1 371
#> 5 2026 3 2026 1 371
#> 6 2026 3 2026 1 371
#> 7 2026 3 2026 1 371
#> 8 2026 3 2026 1 371
#> 9 2026 3 2026 1 371
#> 10 2026 3 2026 1 371
#> # ℹ 15 more rows
#> # ℹ 46 more variables: pagination_limit <int>, pagination_pages <int>,
#> # league_id <chr>, league_name <chr>, league_abbreviation <chr>,
#> # athlete_id <chr>, athlete_display_name <chr>, athlete_short_name <chr>,
#> # athlete_slug <chr>, athlete_position <chr>, athlete_jersey <chr>,
#> # athlete_team_id <chr>, athlete_team_name <chr>,
#> # athlete_team_short_name <chr>, athlete_team_logo <chr>, …
# }