Skip to contents

Returns the NHL Edge shot-speed detail payload for a single team. Wraps https://api-web.nhle.com/v1/edge/team-shot-speed-detail/{teamId}/.... When season is NULL (default) the /now endpoint is used to fetch the current season.

Usage

nhl_edge_team_shot_speed_detail(team_id, season = NULL, game_type = 2)

Arguments

team_id

Integer NHL team ID (e.g., 10 for Toronto Maple Leafs).

season

Optional 4-digit end-year (e.g., 2025 for the 2024-25 season), an 8-character API season (e.g., "20242025"), or NULL (default) for the current season via the /now endpoint.

game_type

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

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
game_center_linkcharacterLink to the NHL game center page for the game.
game_datecharacterGame date.
game_typeintegerGame type (1 = preseason, 2 = regular, 3 = playoffs).
is_home_teamlogicalWhether the team was the home team.
time_in_periodcharacterTime elapsed in the period when the shot occurred.
player_idintegerUnique player identifier.
player_slugcharacterURL slug for the player.
player_first_name_defaultcharacterPlayer first name (default language).
player_last_name_defaultcharacterPlayer last name (default language).
player_last_name_cscharacterPlayer last name (Czech).
player_last_name_ficharacterPlayer last name (Finnish).
player_last_name_skcharacterPlayer last name (Slovak).
shot_speed_imperialnumericShot speed in miles per hour.
shot_speed_metricnumericShot speed in kilometers per hour.
period_descriptor_numberintegerPeriod number.
period_descriptor_period_typecharacterPeriod type (e.g., REG, OT).
period_descriptor_max_regulation_periodsintegerMaximum number of regulation periods.
home_team_common_name_defaultcharacterHome team common name (default language).
home_team_place_name_with_preposition_defaultcharacterHome team place name with preposition (default).
home_team_place_name_with_preposition_frcharacterHome team place name with preposition (French).
home_team_team_logo_lightcharacterURL to the home team light logo.
home_team_team_logo_darkcharacterURL to the home team dark logo.
away_team_common_name_defaultcharacterAway team common name (default language).
away_team_place_name_with_preposition_defaultcharacterAway team place name with preposition (default).
away_team_place_name_with_preposition_frcharacterAway team place name with preposition (French).
away_team_team_logo_lightcharacterURL to the away team light logo.
away_team_team_logo_darkcharacterURL to the away team dark logo.

Examples

# \donttest{
  try(nhl_edge_team_shot_speed_detail(team_id = 10))
#> ── NHL Edge Team Shot Speed Detail ─────────────────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:57:24 UTC
#> # A tibble: 10 × 25
#>    game_center_link    game_date game_type is_home_team time_in_period player_id
#>    <chr>               <chr>         <int> <lgl>        <chr>              <int>
#>  1 /gamecenter/ott-vs… 2026-10-…         2 TRUE         03:32            8478178
#>  2 /gamecenter/mtl-vs… 2026-09-…         2 TRUE         19:19            8478178
#>  3 /gamecenter/nyi-vs… 2026-09-…         2 TRUE         19:28            8478178
#>  4 /gamecenter/nsh-vs… 2026-10-…         2 TRUE         03:04            8479520
#>  5 /gamecenter/mtl-vs… 2026-09-…         2 TRUE         12:39            8477939
#>  6 /gamecenter/tor-vs… 2026-10-…         2 FALSE        11:57            8479318
#>  7 /gamecenter/tor-vs… 2026-10-…         2 FALSE        13:22            8478178
#>  8 /gamecenter/nyi-vs… 2026-09-…         2 TRUE         12:58            8475171
#>  9 /gamecenter/nyi-vs… 2026-09-…         2 TRUE         19:20            8477939
#> 10 /gamecenter/nsh-vs… 2026-10-…         2 TRUE         16:43            8484158
#> # ℹ 19 more variables: player_slug <chr>, player_first_name_default <chr>,
#> #   player_last_name_default <chr>, shot_speed_imperial <dbl>,
#> #   shot_speed_metric <dbl>, period_descriptor_number <int>,
#> #   period_descriptor_period_type <chr>,
#> #   period_descriptor_max_regulation_periods <int>,
#> #   home_team_common_name_default <chr>,
#> #   home_team_place_name_with_preposition_default <chr>, …
# }