Skip to contents

Queries the NHL Stats REST API for skater statistics. Supports various report types and filtering.

Usage

nhl_stats_skaters(
  report_type = "summary",
  season = NULL,
  game_type = 2,
  limit = 50,
  start = 0,
  sort = NULL,
  direction = "DESC",
  lang = "en"
)

Arguments

report_type

Character report type. Default "summary". Common types: "summary", "bios", "faceoffpercentages", "faceoffwins", "goalsForAgainst", "realtime", "penalties", "penaltykill", "powerplay", "puckPossessions", "summaryshooting", "percentages", "scoringRates", "scoringpergame", "shootout", "shottype", "timeonice"

season

Character season in "YYYYYYYY" format (e.g., "20242025"). If NULL, uses current season.

game_type

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

limit

Integer maximum number of results. Default 50.

start

Integer start index for pagination. Default 0.

sort

Character sort column. Default varies by report.

direction

Character sort direction: "DESC" or "ASC". Default "DESC".

lang

Character language code. Default "en".

Value

Returns a data frame with skater statistics.

Examples

# \donttest{
  try(nhl_stats_skaters())
#> ── NHL Stats Skaters ────────────────────────────────────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-02 03:51:38 UTC
#> # A tibble: 50 × 26
#>    assists ev_goals ev_points faceoff_win_pct game_winning_goals games_played
#>      <int>    <int>     <int>           <dbl>              <int>        <int>
#>  1      30        8        23           0.472                  0           15
#>  2      16        6        18           0.568                  1           15
#>  3      18        6        18          NA                      2           15
#>  4      10       11        18           0.2                    3           16
#>  5      15        7        20           0.467                  1           14
#>  6      13        8        15           0.535                  2           16
#>  7      12        6        16           0.545                  1           15
#>  8      12        4        11           0.577                  1           16
#>  9      11        7        14           0.364                  0           16
#> 10      16        3        13          NA                      2           16
#> # ℹ 40 more rows
#> # ℹ 20 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>
# }