get https://api.sportradar.com/nhl//v7//games//shot_zones.
NHL Game Shot Zones provides goals, shots, saves, shooting percentage, shots faced, total shot attempts, and other game statistics for players in each zone.
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 |
number | team - scoring - period | Integer | Period number |
points | team - scoring - period | Integer | Team points in a period |
sequence | team - scoring - period | Integer | Period sequence number |
number | team - scoring - overtime | Integer | Overtime number |
points | team - scoring - overtime | Integer | Team points in overtime |
sequence | team - scoring - overtime | Integer | Period sequence number (The first overtime sequence would be 4 ) |
number | team - scoring - shootout | Integer | Shootout number |
points | team - scoring - shootout | Integer | Team points in shootout |
sequence | team - scoring - shootout | Integer | Shootout sequence number (The first shootout sequence after overtime would be 5 ) |
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 , unnecessary Please 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 |
Game Danger Zone Statistics (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
saves_pct | player - goaltending - danger_zone | Decimal | Save percentage in a danger zone ex. 0.667 |
saves | player - goaltending - danger_zone | Integer | Number of saves in a danger zone |
shots_against | player - goaltending - danger_zone | Integer | Number of shots against in a danger zone |
goals_against | player - goaltending - danger_zone | Integer | Number of goals against in a danger zone |
name | player - goaltending - danger_zone | String | Name of a danger zonedanger_low , danger_medium , danger_high |
shots_attempts | player - statistics - danger_zone | Integer | Number of shot attempts in a danger zone |
shooting_pct | player - statistics - danger_zone | Decimal | Shooting percentage in a danger zone |
blocked_attempts | player - statistics - danger_zone | Integer | Number of blocked attempts (offense) in a danger zone |
missed_shots | player - statistics - danger_zone | Integer | Number of missed shots in a danger zone |
shots | player - statistics - danger_zone | Integer | Number of shots in a danger zone |
goals | player - statistics - danger_zone | Integer | Number of goals in a danger zone |
Game Shot Zone Statistics (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
saves_pct | player - goaltending - shot_zone | Decimal | Save percentage in a shot zone ex. 0.667 |
saves | player - goaltending - shot_zone | Integer | Number of saves in a shot zone |
shots_against | player - goaltending - shot_zone | Integer | Number of shots against in a shot zone |
goals_against | player - goaltending - shot_zone | Integer | Number of goals against in a shot zone |
name | player - goaltending - shot_zone | String | Name of a shot zonedefensive_zone , neutral_zone , center_point , left_point , right_point , low_center_point , low_left_point , low_right_point , outside_right_circle , inside_right_circle , high_slot , inside_left_circle , outside_left_circle , low_right , right_slot , slot , left_slot , low_left , low_slot , down_low |
shots_attempts | player - statistics - shot_zone | Integer | Number of shot attempts in a shot zone |
shooting_pct | player - statistics - shot_zone | Decimal | Shooting percentage in a shot zone |
blocked_attempts | player - statistics - shot_zone | Integer | Number of blocked attempts (offense) in a shot zone |
missed_shots | player - statistics - shot_zone | Integer | Number of missed shots in a shot zone |
shots | player - statistics - shot_zone | Integer | Number of shots in a shot zone |
goals | player - statistics - shot_zone | Integer | Number of goals in a shot zone |
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 |
scratched | player | Boolean | Signifies a player was scratched from a game |
scratched | player | Boolean | Signifies a player started a game |
name_suffix | player | String | Suffix of a player ex. Jr. |
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 |
Player Injuries:
Attribute | Parent Element | Type | Description |
---|---|---|---|
comment | player - injury | String | Text description of an injury ex. "Demko is expected to miss the next six weeks of action, according to Elliotte Friedman of sportsnet.ca." |
desc | player - injury | String | Brief description of an injury ex. Lower-Body |
id | player - injury | GUID | Unique ID of an injury ex. 68a440e4-6ce3-48d7-a299-52412e10c7b7 |
start_date | player - injury | Date | Date an injury transaction goes into effect ex. 2022-12-02 |
status | player - injury | String | Status of an injuryUnknown , Day To Day , Out , Out for Season , Out Indefinitely |
update_date | player - injury | Date | Date of an injury update ex. 2022-12-03 |
Officials:
Attribute | Parent Element | Type | Description |
---|---|---|---|
assignment | official | Integer | Official assignment ex. Linesman or Referee |
experience | official | String | Number of years officiated in the NHL |
first_name | official | String | First name of an official ex. Brian |
full_name | official | String | Full name of an official ex. Brian Pochmara |
id | official | GUID | Unique ID of an official ex. 72fae8f3-6e07-45ba-a0fd-31d51d1ed90b |
last_name | official | String | Last name of an official ex. Pochmara |
number | official | Integer | Number of an official's jersey |
reference | official | String | NHL ID of an official |
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 |