Skip to contents

Aggregator helper that calls nhl_stats_skaters() with report_type = "summary" for every season in [start_season, end_season] and concatenates the results into a single tidy frame. Mirrors the Stats.skater_stats_summary convenience helper from the nhl-api-py Python client.

Usage

nhl_skater_summary_range(start_season, end_season, game_type = 2, limit = 50)

Arguments

start_season

Integer four-digit end year of the first season (e.g. 2022 for the 2021-22 season).

end_season

Integer four-digit end year of the final season (inclusive). Must be >= start_season.

game_type

Integer game type: 2 = regular season (default), 3 = playoffs.

limit

Integer maximum number of rows per season request. Defaults to 50 to match nhl_stats_skaters().

Value

A fastRhockey_data / data.frame of concatenated skater summary stats with an added season column marking the season each row came from. Returns NULL on outer failure.

Examples

# \donttest{
  try(nhl_skater_summary_range(start_season = 2023, end_season = 2024))
#> ── NHL Skater Summary Range ─────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-04-13 17:05:56 UTC
#> # A tibble: 100 × 27
#>    assists ev_goals ev_points faceoff_win_pct game_winning_goals games_played
#>      <int>    <int>     <int>           <dbl>              <int>        <int>
#>  1      89       39        75           0.519                 11           82
#>  2      76       19        64           0.549                 11           80
#>  3      83       22        63           1                      4           82
#>  4      52       43        76           0.421                 13           82
#>  5      69       30        77           0.444                  9           71
#>  6      69       26        72           0.448                  6           79
#>  7      63       33        68           0                      7           82
#>  8      50       42        68           0.490                  9           82
#>  9      67       21        47           0.452                  3           82
#> 10      63       28        68           0.443                  6           80
#> # ℹ 90 more rows
#> # ℹ 21 more variables: goals <int>, last_name <chr>, ot_goals <int>,
#> #   penalty_minutes <int>, player_id <int>, plus_minus <int>, points <int>,
#> #   points_per_game <dbl>, position_code <chr>, pp_goals <int>,
#> #   pp_points <int>, season_id <int>, sh_goals <int>, sh_points <int>,
#> #   shooting_pct <dbl>, shoots_catches <chr>, shots <int>,
#> #   skater_full_name <chr>, team_abbrevs <chr>, time_on_ice_per_game <dbl>, …
# }