NHL Team Summary (Season Range) — nhl_team_summary

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

Usage

nhl_team_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_teams().

Value

A data frame (fastRhockey_data) with the following columns:

col_name	types	description
faceoff_win_pct	numeric	Faceoff win percentage.
games_played	integer	Games played.
goals_against	integer	Goals against.
goals_against_per_game	numeric	Goals against per game.
goals_for	integer	Goals for.
goals_for_per_game	numeric	Goals for per game.
losses	integer	Losses.
ot_losses	integer	Overtime losses.
penalty_kill_net_pct	numeric	Net penalty kill percentage.
penalty_kill_pct	numeric	Penalty kill percentage.
point_pct	numeric	Points percentage.
points	integer	Total points.
power_play_net_pct	numeric	Net power play percentage.
power_play_pct	numeric	Power play percentage.
regulation_and_ot_wins	integer	Wins in regulation and overtime.
season_id	integer	Season identifier.
shots_against_per_game	numeric	Shots against per game.
shots_for_per_game	numeric	Shots for per game.
team_full_name	character	Full team name.
team_id	integer	Unique team identifier.
team_shutouts	integer	Team shutouts.
ties	logical	Ties (legacy; typically unused).
wins	integer	Wins.
wins_in_regulation	integer	Wins in regulation.
wins_in_shootout	integer	Wins in shootout.
season	character	Season the row came from (YYYYYYYY).

Examples

# \donttest{
  try(nhl_team_summary_range(start_season = 2023, end_season = 2024))
#> ── NHL Team Summary Range ───────────────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 07:21:05 UTC
#> # A tibble: 64 × 26
#>    faceoff_win_pct games_played goals_against goals_against_per_game goals_for
#>              <dbl>        <int>         <int>                  <dbl>     <int>
#>  1           0.545           82           174                   2.12       301
#>  2           0.529           82           210                   2.56       262
#>  3           0.513           82           222                   2.71       289
#>  4           0.531           82           220                   2.68       278
#>  5           0.523           82           225                   2.74       267
#>  6           0.467           82           223                   2.72       274
#>  7           0.508           82           256                   3.12       325
#>  8           0.548           82           215                   2.62       281
#>  9           0.491           82           216                   2.63       273
#> 10           0.533           82           254                   3.10       274
#> # ℹ 54 more rows
#> # ℹ 21 more variables: goals_for_per_game <dbl>, losses <int>, ot_losses <int>,
#> #   penalty_kill_net_pct <dbl>, penalty_kill_pct <dbl>, point_pct <dbl>,
#> #   points <int>, power_play_net_pct <dbl>, power_play_pct <dbl>,
#> #   regulation_and_ot_wins <int>, season_id <int>,
#> #   shots_against_per_game <dbl>, shots_for_per_game <dbl>,
#> #   team_full_name <chr>, team_id <int>, team_shutouts <int>, ties <lgl>, …
# }