Skip to contents

Get ESPN NHL Player Box Score

Usage

espn_nhl_player_box(game_id, ...)

Arguments

game_id

ESPN event identifier (character or numeric).

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per player appearance. Skater and goalie rows are combined via dplyr::bind_rows; columns not applicable to a position group are NA. Key columns:

col_nametypesdescription
athlete_idcharacterESPN athlete identifier.
athlete_display_namecharacterAthlete full display name.
athlete_short_namecharacterAthlete short name.
athlete_last_namecharacterAthlete last name.
athlete_jerseycharacterJersey number.
athlete_headshot_hrefcharacterHeadshot image URL.
athlete_position_namecharacterPosition name.
athlete_position_abbreviationcharacterPosition abbreviation.
athlete_activelogicalWhether the athlete was active.
athlete_scratchedlogicalWhether the athlete was scratched.
stat_groupcharacterStat group name ("forwards","defenses","goalies").
team_idcharacterESPN team identifier.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
home_awaycharacter"home" or "away".
team_scorecharacterTeam final score.
team_winnerlogicalWhether the team won.
opponent_team_idcharacterOpponent team identifier.
opponent_team_abbreviationcharacterOpponent team abbreviation.
game_idcharacterESPN event identifier (echoed from arg).
seasonintegerSeason end-year.
season_typeintegerSeason type code.
game_datecharacterGame date-time (ISO 8601).
bscharacterBlocked shots (skaters).
htcharacterHits (skaters).
tkcharacterTakeaways (skaters).
plus_minusintegerPlus/minus rating (skaters).
toicharacterTime on ice (skaters, MM:SS).
pptoicharacterPower play time on ice (skaters, MM:SS).
shtoicharacterShort-handed time on ice (skaters, MM:SS).
estoicharacterEven-strength time on ice (skaters, MM:SS).
shftcharacterTotal shifts (skaters).
gcharacterGoals (skaters).
ytdgcharacterYear-to-date goals (skaters/goalies).
acharacterAssists (skaters).
scharacterShots (skaters).
smcharacterMissed shots (skaters).
sogcharacterShots on goal (skaters).
fwcharacterFaceoffs won (skaters).
flcharacterFaceoffs lost (skaters).
fo_percentcharacterFaceoff percentage (skaters).
gvcharacterGiveaways (skaters).
pncharacterPenalties taken (skaters).
pimcharacterPenalty minutes (skaters/goalies).
gacharacterGoals against (goalies).
sacharacterShots against (goalies).
soscharacterShootout saves (goalies).
sosacharacterShootout shots against (goalies).
svcharacterSaves (goalies).
sv_percentcharacterSave percentage (goalies).
essvcharacterEven-strength saves (goalies).
ppsvcharacterPower play saves (goalies).
shsvcharacterShort-handed saves (goalies).

See also

family_espn_nhl lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_nhl_player_box(game_id = "401688263"))
#> ── NHL Player Box Score data from ESPN.com ──────────────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:27:07 UTC
#> # A tibble: 38 × 53
#>    athlete_id athlete_display_name athlete_short_name athlete_last_name
#>    <chr>      <chr>                <chr>              <chr>            
#>  1 5149125    Connor Bedard        C. Bedard          Bedard           
#>  2 3042056    Tyler Bertuzzi       T. Bertuzzi        Bertuzzi         
#>  3 4874940    Colton Dach          C. Dach            Dach             
#>  4 3042062    Jason Dickinson      J. Dickinson       Dickinson        
#>  5 3115033    Ryan Donato          R. Donato          Donato           
#>  6 3535       Nick Foligno         N. Foligno         Foligno          
#>  7 5428       Taylor Hall          T. Hall            Hall             
#>  8 4392541    Philipp Kurashev     P. Kurashev        Kurashev         
#>  9 3853       Pat Maroon           P. Maroon          Maroon           
#> 10 4422415    Ilya Mikheyev        I. Mikheyev        Mikheyev         
#> # ℹ 28 more rows
#> # ℹ 49 more variables: athlete_jersey <chr>, athlete_headshot_href <chr>,
#> #   athlete_position_name <chr>, athlete_position_abbreviation <chr>,
#> #   athlete_active <lgl>, athlete_scratched <lgl>, stat_group <chr>,
#> #   team_id <chr>, team_abbreviation <chr>, team_display_name <chr>,
#> #   home_away <chr>, team_score <chr>, team_winner <lgl>,
#> #   opponent_team_id <chr>, opponent_team_abbreviation <chr>, game_id <chr>, …
# }