Skip to contents

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

Usage

nhl_goalie_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_goalies().

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
assistsintegerAssists.
games_playedintegerGames played.
games_startedintegerGames started.
goalie_full_namecharacterGoalie full name.
goalsintegerGoals scored.
goals_againstintegerGoals against.
goals_against_averagenumericGoals against average.
last_namecharacterGoalie last name.
lossesintegerLosses.
ot_lossesintegerOvertime losses.
penalty_minutesintegerPenalty minutes.
player_idintegerUnique player identifier.
pointsintegerTotal points (goals + assists).
save_pctnumericSave percentage.
savesintegerSaves made.
season_idintegerSeason identifier.
shoots_catchescharacterShooting/catching hand.
shots_againstintegerShots faced.
shutoutsintegerShutouts.
team_abbrevscharacterTeam abbreviation(s).
tieslogicalTies (legacy; typically NA).
time_on_iceintegerTime on ice in seconds.
winsintegerWins.
seasoncharacterSeason the row came from (e.g. 20232024).

Examples

# \donttest{
  try(nhl_goalie_summary_range(start_season = 2023, end_season = 2024))
#> ── NHL Goalie Summary Range ─────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 07:20:16 UTC
#> # A tibble: 100 × 24
#>    assists games_played games_started goalie_full_name   goals goals_against
#>      <int>        <int>         <int> <chr>              <int>         <int>
#>  1       0           49            48 Linus Ullmark          1            91
#>  2       1           62            62 Alexandar Georgiev     0           156
#>  3       1           58            58 Igor Shesterkin        0           144
#>  4       1           62            61 Jake Oettinger         0           144
#>  5       0           64            64 Connor Hellebuyck      0           157
#>  6       2           60            60 Andrei Vasilevskiy     0           159
#>  7       3           52            48 Vitek Vanecek          0           119
#>  8       1           64            63 Juuse Saros            0           171
#>  9       1           62            60 Ilya Sorokin           0           140
#> 10       2           50            48 Stuart Skinner         0           133
#> # ℹ 90 more rows
#> # ℹ 18 more variables: goals_against_average <dbl>, last_name <chr>,
#> #   losses <int>, ot_losses <int>, penalty_minutes <int>, player_id <int>,
#> #   points <int>, save_pct <dbl>, saves <int>, season_id <int>,
#> #   shoots_catches <chr>, shots_against <int>, shutouts <int>,
#> #   team_abbrevs <chr>, ties <lgl>, time_on_ice <int>, wins <int>, season <chr>
# }