Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Game Analytics

NHL Game Analytics provides detailed team and player analytics for a given game, including corsi, fenwick, on ice shots, and shots by type.

⏱️

Update Frequency

TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.

Data Updates: Realtime


Data Points

League
AttributeParent ElementTypeDescription
idseasonGUIDUnique ID of a game's season

ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f
typeseasonStringSeason type for a game

REG (Regular Season), PST (Postseason), PRE (Preseason)
yearseasonIntegerYear of a game's season

2022 = 2022-23 Season
Boxscore
AttributeParent ElementTypeDescription
end_timegamedateTimeTimestamp of the end of a game

ex. 2022-12-06T06:09:52+00:00
start_timegamedateTimeTimestamp of the start of a game

ex. 2022-12-06T03:38:31+00:00
attendancegameIntegerAttendance of a game

ex. 18420
pointsteamIntegerTotal points for a team
idteamGUIDUnique ID of a team

ex. 4415b0a7-0f24-11e2-8525-18a905767e44
marketteamStringMarket name of a team

ex. Vancouver
nameteamStringTeam name

ex. Canucks
referenceteamStringLeague reference ID of a team

ex. 23
sr_idteamGUIDUnique Sportradar ID of a team

ex. sr:team:3692
hometeamBooleanSignifies the home team when true
strengthteamStringCurrent strength of a team

even, shorthanded, powerplay
total_game_durationgameStringDuration of a game (in game time)

ex. 60:13
clockgameStringClock value of the game

ex. 5:37
periodgameIntegerCurrent period of a game
Game Analytics - Player
AttributeParent ElementTypeDescription
neutral_pctplayer - statistics - starts_by_zoneDecimalPercentage of faceoffs in the neutral zone

ex. 28.6
neutralplayer - statistics - starts_by_zoneIntegerNumber of faceoffs in the neutral zone
defensive_pctplayer - statistics - starts_by_zoneDecimalPercentage of faceoffs in the defensive zone

ex. 57.1
defensiveplayer - statistics - starts_by_zoneIntegerNumber of faceoffs in the defensive zone
offensive_pctplayer - statistics - starts_by_zoneDecimalPercentage of faceoffs in the offensive zone

ex. 14.3
offensiveplayer - statistics - starts_by_zoneIntegerNumber of faceoffs in the offensive zone
typeplayer - statistics - shots_by_type - shot_typeStringType of shot

ex. wrist, slap, backhand, tip, snap, wrap_around, bat, cradle, poke, between_legs
goalsplayer - statistics - shots_by_type - shot_typeIntegerNumber of goals for a type of a shot
pctplayer - statistics - shots_by_type - shot_typeDecimalPercentage of made goals for a type of a shot

ex. 100.0
shotsplayer - statistics - shots_by_type - shot_typeIntegerNumber of shot attempts for a shot type
fenwick_pctplayer - statisticsDecimalPercentage of shot attempts taken by each team in a game (not including blocked shots)
corsi_pctplayer - statisticsDecimalPercentage of shot attempts taken by each team in a game
on_ice_shots_differentialplayer - statisticsIntegerTeam shot differential while on ice (Shots For minus Shots Against)
on_ice_shots_pctplayer - statisticsDecimalShots For divided by Total Shots While on Ice

(ex. Shots For = 8, Shots Against = 4, Shots percentage = 0.667)
average_shot_distanceplayer - statisticsDecimalAverage shot distance (in feet)

ex. 40.0
on_ice_shots_againstplayer - statisticsIntegerTeam shots against while on ice
on_ice_shots_forplayer - statisticsIntegerTeam shots while on ice
fenwick_totalplayer - statisticsIntegerShot attempt differential while playing even strength

(shots on goal towards the opponent's net minus the same shot attempts directed at your own net)
fenwick_againstplayer - statisticsIntegerNumber of shots against based on Fenwick parameters
fenwick_forplayer - statisticsIntegerNumber of shots for based on Fenwick parameters
corsi_totalplayer - statisticsIntegerShot attempt differential while playing even strength

(Includes shots on goal, missed shots on goal, and blocked shot attempts towards the opponent's net minus the same shot attempts directed at your own net.)
corsi_againstplayer - statisticsIntegerNumber of shots against based on Corsi parameters
corsi_forplayer - statisticsIntegerNumber of shots for based on Corsi parameters
Game Analytics - Team
AttributeParent ElementTypeDescription
typeteam - statistics - shots_by_type - shot_typeStringType of shot

ex. wrist, slap, backhand, tip, snap, wrap_around, bat, cradle, poke, between_legs
goalsteam - statistics - shots_by_type - shot_typeIntegerNumber of goals for a type of a shot
pctteam - statistics - shots_by_type - shot_typeDecimalPercentage of made goals for a type of a shot

ex. 100.0
shotsteam - statistics - shots_by_type - shot_typeIntegerNumber of shot attempts for a shot type
pdoteam - statisticsDecimalPDO (The sum of a team's shooting percentage and save percentage, multiplied by 10)

ex. 22.641
fenwick_pctteam - statisticsDecimalPercentage of shot attempts taken by each team in a game (not including blocked shots)
corsi_pctteam - statisticsDecimalPercentage of shot attempts taken by each team in a game
on_ice_shots_differentialteam - statisticsIntegerTeam shot differential (Shots For minus Shots Against)
on_ice_shots_pctteam - statisticsDecimalShots For divided by Total Shots While on Ice

(ex. Shots For = 8, Shots Against = 4, Shots percentage = 0.667)
average_shot_distanceteam - statisticsDecimalAverage shot distance (in feet)

ex. 40.0
on_ice_shots_againstteam - statisticsIntegerTeam shots against while on ice
on_ice_shots_forteam - statisticsIntegerTeam shots while on ice
fenwick_totalteam - statisticsIntegerShot attempt differential while playing even strength

(shots on goal towards the opponent's net minus the same shot attempts directed at your own net)
fenwick_againstteam - statisticsIntegerNumber of shots against based on Fenwick parameters
fenwick_forteam - statisticsIntegerNumber of shots for based on Fenwick parameters
corsi_totalteam - statisticsIntegerShot attempt differential while playing even strength

(Includes shots on goal, missed shots on goal, and blocked shot attempts towards the opponent's net minus the same shot attempts directed at your own net)
corsi_againstteam - statisticsIntegerNumber of shots against based on Corsi parameters
corsi_forteam - statisticsIntegerNumber of shots for based on Corsi parameters
Game
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team

ex. 4416091c-0f24-11e2-8525-18a905767e44
coveragegameStringCoverage level of a game

full, boxscore
entry_modegameStringType of data entry for the game

INGEST (Ingested data from the league), LDE (Sportradar live data entry)
home_teamgameGUIDUnique ID of the home team

ex. 44157522-0f24-11e2-8525-18a905767e44
idgameGUIDUnique ID of a game

ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f
referencegameStringLeague reference ID of a game

ex. 20393
scheduledgamedateTimeScheduled date and time of a game

ex. 2022-12-04T20:00:00Z
sr_idgameGUIDUnique Sportradar ID of a game

ex. sr:match:34542743
statusgameStringThe status of a game

scheduled, created, inprogress, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessary

Please see our FAQ section for a list of game status definitions
awaygame - time_zonesStringTime zone of the away team

ex. US/Pacific
homegame - time_zonesStringTime zone of the home team

ex. US/Eastern
venuegame - time_zonesStringTime zone of the venue

ex. US/Eastern
titlegameStringTitle of a game

ex. Game 3
Player
AttributeParent ElementTypeDescription
captainplayerBooleanType of team captain

C(Team Captain), A(Alternate Captain), N(Not a captain)
first_nameplayerStringFirst name of a player

ex. Sidney
full_nameplayerStringFull name of a player

ex. Sidney Crosby
handednessplayerStringDominant hand of a player

ex. L, R
idplayerGUIDUnique ID of a player

ex. 433de553-0f24-11e2-8525-18a905767e44
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player

ex. Crosby
playedplayerBooleanSignifies a player appeared in a game
positionplayerStringPosition of a player

NA, D, F, F-D, G
primary_positionplayerStringPrimary position of a player

NA, C, D, G, LW, RW
referenceplayerStringLeague reference ID of a player

ex. 8471675
sr_idplayerGUIDUnique Sportradar ID of a player

ex. sr:player:31007
Team
AttributeParent ElementTypeDescription
idteamGUIDUnique ID of a team

ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team

ex. Minnesota
nameteamStringTeam name

ex. Wild
referenceteamStringLeague reference ID of a team

ex. 30
sr_idteamGUIDUnique Sportradar ID of a team

ex. sr:team:3689
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 2500 Victory Avenue
capacityvenueStringCapacity of a venue

ex. 18532
cityvenueStringCity of a venue

ex. Dallas
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique ID of a venue

ex. adbd1acb-a053-4944-ba15-383eda91c12e
latvenue - locationDecimalLatitude of a venue

ex. 44.94478
lngvenue - locationDecimalLongitude of a venue

ex. -93.10118
namevenueStringName of a venue

ex. American Airlines Center
sr_idvenueGUIDUnique Sportradar ID of a venue

ex. sr:venue:5988
statevenueStringState or province of a venue

ex. TX
time_zonevenueStringTime zone of the venue

ex. US/Central
zipvenueIntegerZIP code of a venue

ex. 75219
Language
Credentials
Header
Click Try It! to start a request and see the response here!