Returns NHL team player-level stats (skaters and goalies) for a
given team abbreviation and season.
Uses the new NHL API club-stats endpoint (api-web.nhle.com).
Breaking change: The old team_id (integer) parameter has been replaced
by team_abbr (3-letter string). The season parameter now accepts a
4-digit year (e.g., 2024 for the 2024-25 season).
Value
A data frame (fastRhockey_data) with the following columns:
| col_name | types | description |
| player_id | integer | Unique player identifier. |
| headshot | character | URL to the player's headshot image. |
| position_code | character | Player position code. |
| games_played | integer | Games played. |
| goals | integer | Goals scored. |
| assists | integer | Assists. |
| points | integer | Total points (goals + assists). |
| plus_minus | integer | Plus/minus rating. |
| penalty_minutes | integer | Penalty minutes. |
| power_play_goals | integer | Power-play goals. |
| shorthanded_goals | integer | Short-handed goals. |
| game_winning_goals | integer | Game-winning goals. |
| overtime_goals | integer | Overtime goals. |
| shots | integer | Shots on goal. |
| shooting_pctg | numeric | Shooting percentage. |
| avg_time_on_ice_per_game | numeric | Average time on ice per game. |
| avg_shifts_per_game | numeric | Average shifts per game. |
| faceoff_win_pctg | numeric | Faceoff win percentage. |
| first_name_default | character | Player first name (default language). |
| last_name_default | character | Player last name (default language). |
| last_name_cs | character | Player last name (Czech localization). |
| last_name_fi | character | Player last name (Finnish localization). |
| last_name_sk | character | Player last name (Slovak localization). |
| player_type | character | Player type ("skater" or "goalie"). |
| games_started | integer | Games started (goalies). |
| wins | integer | Wins (goalies). |
| losses | integer | Losses (goalies). |
| overtime_losses | integer | Overtime losses (goalies). |
| goals_against_average | numeric | Goals-against average (goalies). |
| save_percentage | numeric | Save percentage (goalies). |
| shots_against | integer | Shots faced (goalies). |
| saves | integer | Saves made (goalies). |
| goals_against | integer | Goals against (goalies). |
| shutouts | integer | Shutouts (goalies). |
| time_on_ice | integer | Total time on ice (goalies). |
| first_name_cs | character | Player first name (Czech localization). |
| first_name_sk | character | Player first name (Slovak localization). |
| team_abbr | character | Team abbreviation. |
| season | character | Season identifier. |
| game_type | integer | Game type (2 = regular season, 3 = playoffs). |
Examples
# \donttest{
try(nhl_teams_stats(team_abbr = "TBL"))
#> ── NHL Teams Stats Information from NHL.com ─────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 03:26:10 UTC
#> # A tibble: 23 × 40
#> player_id headshot position_code games_played goals assists points plus_minus
#> <int> <chr> <chr> <int> <int> <int> <int> <int>
#> 1 8470621 https:/… R 7 0 0 0 -2
#> 2 8474151 https:/… D 7 0 1 1 2
#> 3 8476453 https:/… R 7 1 5 6 2
#> 4 8476826 https:/… C 7 0 1 1 0
#> 5 8476878 https:/… C 7 0 0 0 -2
#> 6 8477149 https:/… R 2 0 0 0 0
#> 7 8477404 https:/… C 7 2 6 8 3
#> 8 8477416 https:/… R 4 0 0 0 -3
#> 9 8477426 https:/… L 6 0 0 0 -2
#> 10 8478010 https:/… C 7 1 0 1 -1
#> # ℹ 13 more rows
#> # ℹ 32 more variables: penalty_minutes <int>, power_play_goals <int>,
#> # shorthanded_goals <int>, game_winning_goals <int>, overtime_goals <int>,
#> # shots <int>, shooting_pctg <dbl>, avg_time_on_ice_per_game <dbl>,
#> # avg_shifts_per_game <dbl>, faceoff_win_pctg <dbl>,
#> # first_name_default <chr>, last_name_default <chr>, last_name_cs <chr>,
#> # last_name_fi <chr>, last_name_sk <chr>, player_type <chr>, …
# }