Skip to contents

Aggregator helper that iterates every NHL team's season roster (via nhl_teams_roster()) and flattens forwards, defensemen, and goalies into a single tidy data frame. Mirrors the Helpers.all_players convenience helper from the nhl-api-py Python client.

Usage

nhl_all_players_by_season(season, sleep_rate = 0)

Arguments

season

Integer four-digit year representing the start year of the season (e.g. 2024 for the 2024-25 season), matching the convention used by nhl_teams_roster().

sleep_rate

Numeric seconds to Sys.sleep() between per-team API calls. Defaults to 0 (no delay).

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
player_idintegerUnique player identifier.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
full_namecharacterPlayer full name.
sweater_numberintegerJersey number.
position_codecharacterPlayer position code.
shoots_catchescharacterHandedness (shoots/catches).
height_inchesintegerPlayer height in inches.
weight_poundsintegerPlayer weight in pounds.
birth_datecharacterPlayer birth date.
birth_citycharacterPlayer birth city.
birth_countrycharacterPlayer birth country.
headshot_urlcharacterURL to the player headshot image.
team_abbrcharacterTeam abbreviation.
seasonnumericSeason start year (e.g., 2024 for 2024-25).

Examples

# Reads every team's roster, one request per team (over 5 s).
# \donttest{
  try(nhl_all_players_by_season(season = 2024))
#> ── NHL All Players by Season ────────────────────────────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:32:03 UTC
#> # A tibble: 853 × 15
#>    player_id first_name last_name  full_name        sweater_number position_code
#>        <int> <chr>      <chr>      <chr>                     <int> <chr>        
#>  1   8478427 Sebastian  Aho        Sebastian Aho                20 F            
#>  2   8482809 Jackson    Blake      Jackson Blake                53 F            
#>  3   8477478 William    Carrier    William Carrier              28 F            
#>  4   8475791 Taylor     Hall       Taylor Hall                  71 F            
#>  5   8484929 Juha       Jaaska     Juha Jaaska                  54 F            
#>  6   8476873 Mark       Jankowski  Mark Jankowski               77 F            
#>  7   8482093 Seth       Jarvis     Seth Jarvis                  24 F            
#>  8   8479370 Tyson      Jost       Tyson Jost                   27 F            
#>  9   8480829 Jesperi    Kotkaniemi Jesperi Kotkani…             82 F            
#> 10   8476921 Jordan     Martinook  Jordan Martinook             48 F            
#> # ℹ 843 more rows
#> # ℹ 9 more variables: shoots_catches <chr>, height_inches <int>,
#> #   weight_pounds <int>, birth_date <chr>, birth_city <chr>,
#> #   birth_country <chr>, headshot_url <chr>, team_abbr <chr>, season <dbl>
# }