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 ──
#>  Data updated: 2026-06-13 03:25:12 UTC
#> # A tibble: 10 × 27
#>    game_center_link    game_date game_type is_home_team time_in_period player_id
#>    <chr>               <chr>         <int> <lgl>        <chr>              <int>
#>  1 /gamecenter/tor-vs… 2026-04-…         2 FALSE        00:55            8479026
#>  2 /gamecenter/tor-vs… 2026-01-…         2 FALSE        06:55            8479026
#>  3 /gamecenter/wsh-vs… 2026-04-…         2 TRUE         14:00            8479026
#>  4 /gamecenter/tor-vs… 2026-03-…         2 FALSE        10:56            8479026
#>  5 /gamecenter/tor-vs… 2025-11-…         2 FALSE        16:02            8481582
#>  6 /gamecenter/edm-vs… 2025-12-…         2 TRUE         04:52            8475714
#>  7 /gamecenter/pit-vs… 2025-12-…         2 TRUE         06:17            8479026
#>  8 /gamecenter/tor-vs… 2025-10-…         2 FALSE        19:24            8481582
#>  9 /gamecenter/tor-vs… 2026-04-…         2 FALSE        09:17            8481122
#> 10 /gamecenter/phi-vs… 2026-03-…         2 TRUE         01:23            8481122
#> # ℹ 21 more variables: player_slug <chr>, player_first_name_default <chr>,
#> #   player_last_name_default <chr>, player_last_name_cs <chr>,
#> #   player_last_name_fi <chr>, player_last_name_sk <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>, …
# }