Skip to contents

Aggregator helper that combines biographical information from the NHL player landing endpoint with the player's season-by-season career totals. Returns a single multi-row "career-by-season" data frame. Mirrors the Stats.player_career_stats convenience helper from the nhl-api-py Python client.

Usage

nhl_player_career_stats(player_id)

Arguments

player_id

Integer player ID (e.g. 8478402 for Connor McDavid).

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
player_idintegerUnique player identifier.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
positioncharacterPlayer position.
assistsintegerAssists.
game_type_idintegerGame type the row belongs to.
games_playedintegerGames played.
goalsintegerGoals scored.
league_abbrevcharacterLeague abbreviation.
pimintegerPenalty minutes.
pointsintegerTotal points (goals + assists).
seasonintegerSeason (concluding year, YYYY).
sequenceintegerSequence order of the season row.
game_winning_goalsintegerGame-winning goals.
plus_minusintegerPlus/minus rating.
power_play_goalsintegerPower play goals.
shorthanded_goalsintegerShorthanded goals.
shotsintegerShots on goal.
avg_toicharacterAverage time on ice.
faceoff_winning_pctgnumericFaceoff winning percentage.
ot_goalsintegerOvertime goals.
power_play_pointsintegerPower play points.
shooting_pctgnumericShooting percentage.
shorthanded_pointsintegerShorthanded points.
team_name_defaultcharacterTeam name (default locale).
team_name_cscharacterTeam name (Czech locale).
team_name_decharacterTeam name (German locale).
team_name_escharacterTeam name (Spanish locale).
team_name_ficharacterTeam name (Finnish locale).
team_name_skcharacterTeam name (Slovak locale).
team_name_svcharacterTeam name (Swedish locale).
team_name_frcharacterTeam name (French locale).
team_common_name_defaultcharacterTeam common name (default locale).
team_common_name_cscharacterTeam common name (Czech locale).
team_common_name_decharacterTeam common name (German locale).
team_common_name_escharacterTeam common name (Spanish locale).
team_common_name_ficharacterTeam common name (Finnish locale).
team_common_name_skcharacterTeam common name (Slovak locale).
team_common_name_svcharacterTeam common name (Swedish locale).
team_place_name_with_preposition_defaultcharacterTeam place name with preposition.
team_place_name_with_preposition_frcharacterTeam place name with preposition (FR).

Examples

# \donttest{
  try(nhl_player_career_stats(player_id = 8478402))
#> ── NHL Player Career Stats ──────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 07:20:17 UTC
#> # A tibble: 36 × 41
#>    player_id first_name last_name position assists game_type_id games_played
#>        <int> <chr>      <chr>     <chr>      <int>        <int>        <int>
#>  1   8478402 Connor     McDavid   C              7            2            7
#>  2   8478402 Connor     McDavid   C             50            2           33
#>  3   8478402 Connor     McDavid   C             65            2           41
#>  4   8478402 Connor     McDavid   C             32            2           17
#>  5   8478402 Connor     McDavid   C             15            3           14
#>  6   8478402 Connor     McDavid   C             41            2           63
#>  7   8478402 Connor     McDavid   C              6            2            7
#>  8   8478402 Connor     McDavid   C             71            2           56
#>  9   8478402 Connor     McDavid   C             15            3           14
#> 10   8478402 Connor     McDavid   C             76            2           47
#> # ℹ 26 more rows
#> # ℹ 34 more variables: goals <int>, league_abbrev <chr>, pim <int>,
#> #   points <int>, season <int>, sequence <int>, game_winning_goals <int>,
#> #   plus_minus <int>, power_play_goals <int>, shorthanded_goals <int>,
#> #   shots <int>, avg_toi <chr>, faceoff_winning_pctg <dbl>, ot_goals <int>,
#> #   power_play_points <int>, shooting_pctg <dbl>, shorthanded_points <int>,
#> #   team_name_default <chr>, team_name_cs <chr>, team_name_de <chr>, …
# }