Skip to contents

Get ESPN NHL Season Athletes (core-v2)

Usage

espn_nhl_season_athletes(
  season = most_recent_nhl_season(),
  limit = 100,
  page = 1,
  ...
)

Arguments

season

Season end-year (e.g. 2026). Defaults to most_recent_nhl_season().

limit

Number of athletes per page (default 100). The NHL season athlete list exceeds 11,000 entries across ~2,300 pages; use page to iterate.

page

Page number (1-indexed, default 1). Check the returned page_count column to determine how many pages are available.

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per athlete reference for the requested page:

col_nametypesdescription
refcharacter$ref URL for the athlete-in-season object.
athlete_idcharacterESPN athlete id parsed from the $ref URL.
seasonintegerSeason year (echoed from arg).
pageintegerPage number (echoed from arg).
countintegerTotal athletes in the collection.
page_countintegerTotal pages in the collection.

See also

family_espn_nhl lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_nhl_season_athletes(season = 2026, limit = 10, page = 1))
#> ── NHL Season Athletes data from ESPN core-v2 ───────────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:27:19 UTC
#> # A tibble: 10 × 6
#>    ref                                  athlete_id season  page count page_count
#>    <chr>                                <chr>       <int> <int> <int>      <int>
#>  1 http://sports.core.api.espn.com/v2/… 1            2026     1 11976       1198
#>  2 http://sports.core.api.espn.com/v2/… 2            2026     1 11976       1198
#>  3 http://sports.core.api.espn.com/v2/… 3            2026     1 11976       1198
#>  4 http://sports.core.api.espn.com/v2/… 4            2026     1 11976       1198
#>  5 http://sports.core.api.espn.com/v2/… 5            2026     1 11976       1198
#>  6 http://sports.core.api.espn.com/v2/… 6            2026     1 11976       1198
#>  7 http://sports.core.api.espn.com/v2/… 7            2026     1 11976       1198
#>  8 http://sports.core.api.espn.com/v2/… 8            2026     1 11976       1198
#>  9 http://sports.core.api.espn.com/v2/… 9            2026     1 11976       1198
#> 10 http://sports.core.api.espn.com/v2/… 10           2026     1 11976       1198
# }