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-13 21:33:18 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      38        9        27           0.476                  0           20
#>  2      19        9        23           0.587                  3           20
#>  3      18       11        23           0.2                    4           21
#>  4      22        8        21          NA                      3           20
#>  5      20        7        22           0.507                  1           20
#>  6      17        9        19           0.545                  2           21
#>  7      20        5        19           1                      1           19
#>  8      24        3        14           0                      1           20
#>  9      16        6        17           0.562                  2           20
#> 10      22        4        16          NA                      2           21
#> # ℹ 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>
# }