get https://api.sportradar.com/nhl//v7//games//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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | season | GUID | Unique ID of a game's season ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f |
type | season | String | Season type for a gameREG (Regular Season), PST (Postseason), PRE (Preseason) |
year | season | Integer | Year of a game's season2022 = 2022-23 Season |
Boxscore:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
end_time | game | dateTime | Timestamp of the end of a game ex. 2022-12-06T06:09:52+00:00 |
start_time | game | dateTime | Timestamp of the start of a game ex. 2022-12-06T03:38:31+00:00 |
attendance | game | Integer | Attendance of a game ex. 18420 |
points | team | Integer | Total points for a team |
id | team | GUID | Unique ID of a team ex. 4415b0a7-0f24-11e2-8525-18a905767e44 |
market | team | String | Market name of a team ex. Vancouver |
name | team | String | Team name ex. Canucks |
reference | team | String | League reference ID of a team ex. 23 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3692 |
home | team | Boolean | Signifies the home team when true |
strength | team | String | Current strength of a teameven, shorthanded, powerplay |
total_game_duration | game | String | Duration of a game (in game time) ex. 60:13 |
clock | game | String | Clock value of the game ex. 5:37 |
period | game | Integer | Current period of a game |
Game Analytics - Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
neutral_pct | player - statistics - starts_by_zone | Decimal | Percentage of faceoffs in the neutral zone ex. 28.6 |
neutral | player - statistics - starts_by_zone | Integer | Number of faceoffs in the neutral zone |
defensive_pct | player - statistics - starts_by_zone | Decimal | Percentage of faceoffs in the defensive zone ex. 57.1 |
defensive | player - statistics - starts_by_zone | Integer | Number of faceoffs in the defensive zone |
offensive_pct | player - statistics - starts_by_zone | Decimal | Percentage of faceoffs in the offensive zone ex. 14.3 |
offensive | player - statistics - starts_by_zone | Integer | Number of faceoffs in the offensive zone |
type | player - statistics - shots_by_type - shot_type | String | Type of shot ex. wrist, slap, backhand, tip, snap, wrap_around, bat, cradle, poke, between_legs |
goals | player - statistics - shots_by_type - shot_type | Integer | Number of goals for a type of a shot |
pct | player - statistics - shots_by_type - shot_type | Decimal | Percentage of made goals for a type of a shot ex. 100.0 |
shots | player - statistics - shots_by_type - shot_type | Integer | Number of shot attempts for a shot type |
fenwick_pct | player - statistics | Decimal | Percentage of shot attempts taken by each team in a game (not including blocked shots) |
corsi_pct | player - statistics | Decimal | Percentage of shot attempts taken by each team in a game |
on_ice_shots_differential | player - statistics | Integer | Team shot differential while on ice (Shots For minus Shots Against) |
on_ice_shots_pct | player - statistics | Decimal | Shots For divided by Total Shots While on Ice (ex. Shots For = 8, Shots Against = 4, Shots percentage = 0.667) |
average_shot_distance | player - statistics | Decimal | Average shot distance (in feet) ex. 40.0 |
on_ice_shots_against | player - statistics | Integer | Team shots against while on ice |
on_ice_shots_for | player - statistics | Integer | Team shots while on ice |
fenwick_total | player - statistics | Integer | Shot 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_against | player - statistics | Integer | Number of shots against based on Fenwick parameters |
fenwick_for | player - statistics | Integer | Number of shots for based on Fenwick parameters |
corsi_total | player - statistics | Integer | Shot 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_against | player - statistics | Integer | Number of shots against based on Corsi parameters |
corsi_for | player - statistics | Integer | Number of shots for based on Corsi parameters |
Game Analytics - Team:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
type | team - statistics - shots_by_type - shot_type | String | Type of shot ex. wrist, slap, backhand, tip, snap, wrap_around, bat, cradle, poke, between_legs |
goals | team - statistics - shots_by_type - shot_type | Integer | Number of goals for a type of a shot |
pct | team - statistics - shots_by_type - shot_type | Decimal | Percentage of made goals for a type of a shot ex. 100.0 |
shots | team - statistics - shots_by_type - shot_type | Integer | Number of shot attempts for a shot type |
pdo | team - statistics | Decimal | PDO (The sum of a team's shooting percentage and save percentage, multiplied by 10) ex. 22.641 |
fenwick_pct | team - statistics | Decimal | Percentage of shot attempts taken by each team in a game (not including blocked shots) |
corsi_pct | team - statistics | Decimal | Percentage of shot attempts taken by each team in a game (not including blocked shots) |
on_ice_shots_differential | team - statistics | Integer | Team shot differential (Shots For minus Shots Against) |
on_ice_shots_pct | team - statistics | Decimal | Shots For divided by Total Shots While on Ice (ex. Shots For = 8, Shots Against = 4, Shots percentage = 0.667) |
average_shot_distance | team - statistics | Decimal | Average shot distance (in feet) ex. 40.0 |
on_ice_shots_against | team - statistics | Integer | Team shots against while on ice |
on_ice_shots_for | team - statistics | Integer | Team shots while on ice |
fenwick_total | team - statistics | Integer | Shot 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_against | team - statistics | Integer | Number of shots against based on Fenwick parameters |
fenwick_for | team - statistics | Integer | Number of shots for based on Fenwick parameters |
corsi_total | team - statistics | Integer | Shot 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_against | team - statistics | Integer | Number of shots against based on Corsi parameters |
corsi_for | team - statistics | Integer | Number of shots for based on Corsi parameters |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 4416091c-0f24-11e2-8525-18a905767e44 |
coverage | game | String | Coverage level of a gamefull, boxscore |
entry_mode | game | String | Type of data entry for the gameINGEST(Ingested data from the league), LDE(Sportradar live data entry) |
home_team | game | GUID | Unique ID of the home team ex. 44157522-0f24-11e2-8525-18a905767e44 |
id | game | GUID | Unique ID of a game ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f |
reference | game | String | League reference ID of a game ex. 20393 |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-12-04T20:00:00Z |
sr_id | game | GUID | Unique Sportradar ID of a game ex. sr:match:34542743 |
status | game | String | The status of a gamescheduled, created, inprogress, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessaryPlease see our FAQ section for a list of game status definitions |
away | game - time_zones | String | Time zone of the away team ex. US/Pacific |
home | game - time_zones | String | Time zone of the home team ex. US/Eastern |
venue | game - time_zones | String | Time zone of the venue ex. US/Eastern |
title | game | String | Title of a game ex. Game 3 |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
captain | player | Boolean | Type of team captainC(Team Captain), A(Alternate Captain), N(Not a captain) |
first_name | player | String | First name of a player ex. Sidney |
full_name | player | String | Full name of a player ex. Sidney Crosby |
handedness | player | String | Dominant hand of a player ex. L, R |
id | player | GUID | Unique ID of a player ex. 433de553-0f24-11e2-8525-18a905767e44 |
jersey_number | player | Integer | Number of a player's jersey |
last_name | player | String | Last name of a player ex. Crosby |
played | player | Boolean | Signifies a player appeared in a game |
position | player | String | Position of a playerNA, D, F, F-D, G |
primary_position | player | String | Primary position of a playerNA, C, D, G, LW, RW |
reference | player | String | League reference ID of a player ex. 8471675 |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:31007 |
Team:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | team | GUID | Unique ID of a team ex. bdc11650-6f74-49c4-875e-778aeb7632d9 |
market | team | String | Market name of a team ex. Minnesota |
name | team | String | Team name ex. Wild |
reference | team | String | League reference ID of a team ex. 30 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3689 |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 2500 Victory Avenue |
capacity | venue | String | Capacity of a venue ex. 18532 |
city | venue | String | City of a venue ex. Dallas |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. adbd1acb-a053-4944-ba15-383eda91c12e |
lat | venue - location | Decimal | Latitude of a venue ex. 44.94478 |
lng | venue - location | Decimal | Longitude of a venue ex. -93.10118 |
name | venue | String | Name of a venue ex. American Airlines Center |
sr_id | venue | GUID | Unique Sportradar ID of a venue ex. sr:venue:5988 |
state | venue | String | State or province of a venue ex. TX |
time_zone | venue | String | Time zone of the venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 75219 |