Skip to contents

Get ESPN NHL Play-by-Play

Usage

espn_nhl_pbp(game_id, ...)

Arguments

game_id

ESPN event identifier (character or numeric).

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per play:

col_nametypesdescription
idcharacterESPN play identifier.
sequence_numbercharacterPlay sequence number.
type_idcharacterPlay type identifier.
type_textcharacterPlay type display text.
textcharacterPlay description text.
away_scoreintegerAway team score at time of play.
home_scoreintegerHome team score at time of play.
scoring_playlogicalWhether the play resulted in a goal.
score_valueintegerGoal value (1 for regulation/OT goals).
shooting_playlogicalWhether the play was a shot attempt.
wallclockcharacterWall-clock timestamp (ISO 8601).
period_numberintegerPeriod number (1-3 regulation, 4+ OT/SO).
period_display_valuecharacterPeriod display label (e.g. "1st Period").
clock_display_valuecharacterGame clock display string (e.g. "14:32").
team_idcharacterESPN team identifier for the acting team.
coordinate_xnumericX coordinate of play location.
coordinate_ynumericY coordinate of play location.
strength_idcharacterStrength situation identifier.
strength_textcharacterStrength situation text (e.g. "Even Strength").
shot_info_idcharacterShot type identifier.
shot_info_textcharacterShot type text (e.g. "Wrist Shot").
athlete_id_1characterPrimary participant athlete identifier.
athlete_id_2characterSecondary participant athlete identifier.
athlete_id_3characterTertiary participant athlete identifier.
home_team_idcharacterHome team ESPN identifier.
home_team_namecharacterHome team name.
home_team_locationcharacterHome team city/location.
home_team_abbrevcharacterHome team abbreviation.
home_team_display_namecharacterHome team display name.
home_team_colorcharacterHome team primary color hex.
home_team_alternate_colorcharacterHome team alternate color hex.
home_team_logocharacterHome team logo URL.
home_team_scorecharacterHome team final score.
home_team_winnerlogicalWhether the home team won.
away_team_idcharacterAway team ESPN identifier.
away_team_namecharacterAway team name.
away_team_locationcharacterAway team city/location.
away_team_abbrevcharacterAway team abbreviation.
away_team_display_namecharacterAway team display name.
away_team_colorcharacterAway team primary color hex.
away_team_alternate_colorcharacterAway team alternate color hex.
away_team_logocharacterAway team logo URL.
away_team_scorecharacterAway team final score.
away_team_winnerlogicalWhether the away team won.
game_idcharacterESPN event identifier (echoed from arg).
seasonintegerSeason end-year.
season_typeintegerSeason type code.
game_datecharacterGame date-time (ISO 8601).

See also

Other ESPN NHL Functions: espn_nhl_athletes_index(), espn_nhl_award(), espn_nhl_awards(), espn_nhl_calendar(), espn_nhl_calendar_offseason(), espn_nhl_calendar_ondays(), espn_nhl_calendar_postseason(), espn_nhl_calendar_regular_season(), espn_nhl_coach(), espn_nhl_coach_record(), espn_nhl_coach_season(), espn_nhl_coaches(), espn_nhl_conferences(), espn_nhl_countries(), espn_nhl_draft(), espn_nhl_franchise(), espn_nhl_franchises(), espn_nhl_game(), espn_nhl_game_all(), espn_nhl_game_broadcasts(), espn_nhl_game_competition(), espn_nhl_game_leaders(), espn_nhl_game_odds(), espn_nhl_game_official_detail(), espn_nhl_game_officials(), espn_nhl_game_play(), espn_nhl_game_play_personnel(), espn_nhl_game_plays(), espn_nhl_game_powerindex(), espn_nhl_game_predictor(), espn_nhl_game_probabilities(), espn_nhl_game_propbets(), espn_nhl_game_scoringplays(), espn_nhl_game_situation(), espn_nhl_game_status(), espn_nhl_game_team(), espn_nhl_game_team_leaders(), espn_nhl_game_team_linescores(), espn_nhl_game_team_record(), espn_nhl_game_team_roster(), espn_nhl_game_team_statistics(), espn_nhl_game_teams(), espn_nhl_games(), espn_nhl_injuries(), espn_nhl_leaders(), espn_nhl_leaders_core(), espn_nhl_league_notes(), espn_nhl_league_root(), espn_nhl_news(), espn_nhl_player_awards(), espn_nhl_player_bio(), espn_nhl_player_box(), espn_nhl_player_career_stats(), espn_nhl_player_contracts(), espn_nhl_player_core(), espn_nhl_player_eventlog(), espn_nhl_player_gamelog(), espn_nhl_player_info(), espn_nhl_player_injuries(), espn_nhl_player_news(), espn_nhl_player_notes(), espn_nhl_player_overview(), espn_nhl_player_records(), espn_nhl_player_seasons(), espn_nhl_player_splits(), espn_nhl_player_statistics(), espn_nhl_player_statisticslog(), espn_nhl_player_stats_v3(), espn_nhl_player_vs_player(), espn_nhl_players_index(), espn_nhl_position(), espn_nhl_positions(), espn_nhl_providers(), espn_nhl_schedule(), espn_nhl_scoreboard(), espn_nhl_season_athletes(), espn_nhl_season_awards(), espn_nhl_season_coaches(), espn_nhl_season_draft(), espn_nhl_season_draft_round_picks(), espn_nhl_season_freeagents(), espn_nhl_season_futures(), espn_nhl_season_group(), espn_nhl_season_group_children(), espn_nhl_season_group_teams(), espn_nhl_season_groups(), espn_nhl_season_info(), espn_nhl_season_players(), espn_nhl_season_pointer(), espn_nhl_season_powerindex(), espn_nhl_season_powerindex_leaders(), espn_nhl_season_team(), espn_nhl_season_teams(), espn_nhl_season_type(), espn_nhl_season_type_corrections(), espn_nhl_season_type_leaders(), espn_nhl_season_types(), espn_nhl_season_week(), espn_nhl_season_week_games(), espn_nhl_season_weeks(), espn_nhl_seasons(), espn_nhl_standings(), espn_nhl_standings_core(), espn_nhl_statistics_league(), espn_nhl_summary(), espn_nhl_talentpicks(), espn_nhl_team(), espn_nhl_team_box(), espn_nhl_team_core(), espn_nhl_team_depthcharts(), espn_nhl_team_history(), espn_nhl_team_injuries(), espn_nhl_team_leaders(), espn_nhl_team_news(), espn_nhl_team_record(), espn_nhl_team_roster(), espn_nhl_team_schedule(), espn_nhl_team_transactions(), espn_nhl_teams_core(), espn_nhl_teams_site(), espn_nhl_tournaments(), espn_nhl_transactions(), espn_nhl_venue(), espn_nhl_venues()

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_nhl_pbp(game_id = "401688263"))
#> ── NHL Play-by-Play data from ESPN.com ──────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-12 14:17:44 UTC
#> # A tibble: 244 × 48
#>    id              sequence_number type_id type_text text  away_score home_score
#>    <chr>           <chr>           <chr>   <chr>     <chr>      <int>      <int>
#>  1 40168826300000… 2               518     Period S… Star…          0          0
#>  2 40168826300000… 3               502     Face Off  Dyla…          0          0
#>  3 40168826300000… 4               503     Hit       Vlad…          0          0
#>  4 40168826300000… 5               506     Shot      Vlad…          0          0
#>  5 40168826300000… 6               506     Shot      Albe…          0          0
#>  6 40168826300000… 7               1402    Giveaway  Give…          0          0
#>  7 40168826300000… 8               507     Missed    Fran…          0          0
#>  8 40168826300000… 9               503     Hit       Mich…          0          0
#>  9 40168826300000… 10              1402    Giveaway  Give…          0          0
#> 10 40168826300000… 11              508     Blocked   Ben …          0          0
#> # ℹ 234 more rows
#> # ℹ 41 more variables: scoring_play <lgl>, score_value <int>,
#> #   shooting_play <lgl>, wallclock <chr>, period_number <int>,
#> #   period_display_value <chr>, clock_display_value <chr>, team_id <chr>,
#> #   coordinate_x <dbl>, coordinate_y <dbl>, strength_id <chr>,
#> #   strength_text <chr>, shot_info_id <chr>, shot_info_text <chr>,
#> #   athlete_id_1 <chr>, athlete_id_2 <chr>, athlete_id_3 <chr>, …
# }