NFL Push Statistics provides detailed, real-time game stats at the team and player level for all live games.
Syntax
https://api.sportradar.com/nfl/official/{access_level}/stream/{language_code}/statistics/subscribe?api_key={your_api_key} |
Parameters
Parameter | Description |
---|---|
access_level | Defines the access level of your API keyproduction , trial |
language_code | Optional code for supported languagesen (English) |
your_api_key | Your API key |
Optional Query String Parameters
By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.
Optional query string parameters must be added after your API key with an ampersand (&
). If you are filtering for more than one result, separate the results with a comma (,
) and no spaces.
Parameter | Description |
---|---|
locale | Language returned expressed as a 2-letter codeen (English)Example: locale=en |
match_id | Match id Example: match_id=sd:match:673b459c-7506-4c11-9273-1b9502537f1d |
participant | Team or player id Example: team_id=sd:team:4415b0a7-0f24-11e2-8525-18a905767e44 or sd:player:e3181493-6a2a-4e95-aa6f-3fc1ddeb7512 |
status | Game statusinprogress , created Example: status=inprogress |
Code Samples
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl/official/trial/stream/en/statistics/subscribe?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
import requests
import json
r = requests.get("https://api.sportradar.com/nfl/official/trial/stream/en/statistics/subscribe",
params = {'api_key': 'your_api_key'},
allow_redirects=False)
redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)
for line in r.iter_lines():
# filter out keep-alive new lines
if line:
decoded_line = line.decode('utf-8')
print(json.loads(decoded_line))
curl -L GET 'api.sportradar.us/nfl/official/trial/stream/en/statistics/subscribe?api_key={your_api_key}'
Samples with Query String Params
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl/official/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
import requests
import json
r = requests.get("https://api.sportradar.com/nfl/official/trial/stream/en/statistics/subscribe",
params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
allow_redirects=False)
redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)
for line in r.iter_lines():
# filter out keep-alive new lines
if line:
decoded_line = line.decode('utf-8')
print(json.loads(decoded_line))
curl -L GET 'api.sportradar.us/nfl/official/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'
Response Samples
The above commands return json like this.
Full Game Sample
Click here for Push samples (Events, Pulse, Statistics) of a complete game. Please note that the Push Statistics feed has been enhanced to include addition game data. See here for an updated Statistics sample.
Data Points
Boxscore:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attendance | payload | Integer | Attendance of a game ex. 73242 |
remaining_challenges | away | Integer | Away team challenges remaining |
remaining_timeouts | away | Integer | Away team timeouts remaining |
used_challenges | away | Integer | Away team challenges used |
used_timeouts | away | Integer | Away team timeouts used |
points | away | Integer | Away team total points |
clock | payload | String | Clock value of the game ex. 12:37 |
remaining_challenges | home | Integer | Home team challenges remaining |
remaining_timeouts | home | Integer | Home team timeouts remaining |
used_challenges | home | Integer | Home team challenges used |
used_timeouts | home | Integer | Home team timeouts used |
points | home | Integer | Home team total points |
quarter | payload | Integer | Quarter number of the game |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | away | String | Away team alias ex. MIN (Minnesota) |
id | away | GUID | Unique ID of the away team ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724 |
market | away | String | Away team market name ex. Minnesota |
name | away | String | Away team name ex. Vikings |
sr_id | away | String | Unique Sportradar ID of the away team ex. sr:competitor:4376 |
conference_game | payload | Boolean | Signifies an in-Conference matchup ex. (NFC vs. NFC) |
coverage | payload | String | Coverage level of a gamefull |
duration | payload | String | Duration of the game ex. 2:52 |
entry_mode | payload | String | Type of data entry for the gameLDE (Live Data Entry) |
alias | home | String | Home team alias ex. GB (Green Bay) |
id | home | GUID | Unique ID of the home team ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8 |
market | home | String | Home team market name ex. Green Bay |
name | home | String | Home team name ex. Packers |
sr_id | home | String | Unique Sportradar ID of the home team ex. sr:competitor:4391 |
id | payload | GUID | Unique ID of a game ex. 13025660-aa95-4885-b33e-3a3554d4c4c3 |
neutral_site | payload | Boolean | Signifies a game is held at a neutral site when true |
scheduled | payload | Date/Time | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
sr_id | payload | String | Unique Sportradar ID of a game ex. sr:match:33623305 |
status | payload | String | Game status scheduled , created , inprogress , complete , closed , cancelled , delayed , suspended , postponed , time-tbd , if necessary , unnecessary See our NFL FAQ for game status descriptions |
away | time_zones | String | Time zone of the away team ex. US/Pacific |
home | time_zones | String | Time zone of the home team ex. US/Eastern |
venue | time_zones | String | Time zone of the venue ex. US/Eastern |
title | payload | String | Game title ex. NFC Championship |
wx_condition | payload | String | Weather conditions for a game ex. Partly cloudy |
wx_humidity | payload | Byte | Humidity conditions for a game ex. 44 |
wx_temp | payload | Byte | Temperature of a game in Fahrenheit ex. 57 |
wx_wind_direction | payload | String | Wind direction for a game ex. N |
wx_wind_speed | payload | Byte | Wind speed for a game in MPH |
Game Statistics - Conversions (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | conversions | Integer | Number of two-point conversion attempts |
category | conversions | String | Category of conversionpass , receive , rush , turnover |
successes | conversions | Integer | Number of successful two-point conversions |
Game Statistics - Defense (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
assists | defense | Integer | Number of defensive assisted tackles *Does not include misc. or special teams tackles |
batted_passes | defense | Integer | Number of batted passes |
blitzes | defense | Integer | Number of blitzes |
combined | defense | Integer | Number of combined (assists + tackles ) defensive tackles*Does not include misc. or special teams tackles |
def_comps | defense | Integer | Number of completed passes with a defensive player covering on the play |
def_targets | defense | Integer | Number of defensive targets |
forced_fumbles | defense | Integer | Number of forced fumbles |
fumble_recoveries | defense | Integer | Number of fumble recoveries |
hurries | defense | Integer | Number of hurries |
interceptions | defense | Integer | Number of interceptions |
knockdowns | defense | Integer | Number of knockdowns |
misc_assists | defense | Integer | Number of miscellaneous assisted tackles. Ex: An assisted tackle by an offensive player on a defensive interception or fumble return |
misc_forced_fumbles | defense | Integer | Number of miscellaneous forced fumbles. Ex: A forced fumble by an offensive player on a defensive interception or fumble return |
misc_fumble_recoveries | defense | Integer | Number of miscellaneous fumble recoveries. Ex: A fumble recovery by an offensive player on a defensive interception or fumble return |
misc_tackles | defense | Integer | Number of miscellaneous tackles. Ex: A solo tackle by an offensive player on a defensive interception or fumble return |
missed_tackles | defense | Integer | Number of missed tackles |
passes_defended | defense | Integer | Number of passes defended |
qb_hits | defense | Integer | Number of hits on the quarterback |
sack_yards | defense | Integer | Number of sack yards |
sacks | defense | Integer | Number of sacks |
safeties | defense | Integer | Number of safeties |
sp_assists | defense | Integer | Number of special teams assisted tackles |
sp_blocks | defense | Integer | Number of blocked kicks/punts |
sp_forced_fumbles | defense | Integer | Number of special teams forced fumbles |
sp_fumble_recoveries | defense | Integer | Number of special teams fumble recoveries |
sp_tackles | defense | Integer | Number of special teams tackles |
tackles | defense | Integer | Number of defensive tackles *Does not include misc. or special teams tackles |
tloss | defense | Integer | Number of tackles for a loss |
tloss_yards | defense | Integer | Number of tackles for a loss yardage |
Game Statistics - Extra Points (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | extra_points | Integer | Number of attempted extra points |
blocked | extra_points | Integer | Number of blocked extra points |
made | extra_points | Integer | Number of made extra points |
missed | extra_points | Integer | Number of missed extra points |
percent | extra_points | Decimal | Extra point percentage ex. 75.0 |
Game Statistics - Field Goals (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | field_goals | Integer | Number of attempted field goals |
attempts_19 | field_goals | Integer | Number of attempted field goals between 1-19 yards |
attempts_29 | field_goals | Integer | Number of attempted field goals between 20-29 yards |
attempts_39 | field_goals | Integer | Number of attempted field goals between 30-39 yards |
attempts_49 | field_goals | Integer | Number of attempted field goals between 40-49 yards |
attempts_50 | field_goals | Integer | Number of attempted field goals of 50 yards or more |
avg_yards | field_goals | Decimal | Average number of yards on attempted field goals ex. 38.5 |
blocked | field_goals | Integer | Number of blocked field goals |
longest | field_goals | Integer | Number of yards of longest made field goal |
made | field_goals - player | Integer | Number of made field goals |
made_19 | field_goals | Integer | Number of successful field goals between 1-19 yards |
made_29 | field_goals | Integer | Number of successful field goals between 20-29 yards |
made_39 | field_goals | Integer | Number of successful field goals between 30-39 yards |
made_49 | field_goals | Integer | Number of successful field goals between 40-49 yards |
made_50 | field_goals | Integer | Number of successful field goals of 50 yards or more |
missed | field_goals | Integer | Number of missed field goals |
pct | field_goals | Decimal | Field goal percentage ex. 75.0 |
yards | field_goals | Integer | Number of total yards on successful field goals |
Game Statistics - Fumbles (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
ez_rec_tds | fumbles | Integer | Number of end zone fumble recovery touchdowns |
forced_fumbles | fumbles | Integer | Number of forced fumbles |
fumbles | fumbles | Integer | Number of fumbles |
lost_fumbles | fumbles | Integer | Number of lost fumbles |
opp_rec | fumbles | Integer | Number of opponent fumble recoveries |
opp_rec_tds | fumbles | Integer | Number of opponent fumble recovery touchdowns |
opp_rec_yards | fumbles | Integer | Number of opponent fumble recovery yards |
out_of_bounds | fumbles | Integer | Number of opponent fumbles out of bounds |
own_rec | fumbles | Integer | Number of own fumble recoveries |
own_rec_tds | fumbles | Integer | Number of own fumble recovery touchdowns |
own_rec_yards | fumbles | Integer | Number of own fumble recovery yards |
Game Statistics - Interception Returns (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | int_returns | Decimal | Average number of yards on interception returns ex. 38.5 |
longest | int_returns | Integer | Number of yards of longest interception return |
longest_touchdown | int_returns | Integer | Number of yards of longest interception return for a touchdown |
returns | int_returns | Integer | Number of interception returns |
touchdowns | int_return | Integer | Number of interception return touchdowns |
yards | int_returns | Integer | Number of total interception return yards |
Game Statistics - Kick Returns (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | kick_returns | Decimal | Average number of yards on kick returns ex. 19.5 |
faircatches | kick_returns | Integer | Number of fair catches on kick returns |
longest | kick_returns | Integer | Number of yards of longest kick return |
longest_touchdown | kick_returns | Integer | Number of yards of longest kick return for a touchdown |
returns | kick_returns | Integer | Number of kick returns |
touchdowns | kick_returns | Integer | Number of kick return touchdowns |
yards | kick_returns | Integer | Number of total kick return yards |
Game Statistics - Kickoffs (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
endzone | kickoffs | Integer | Number of kickoffs into the endzone |
inside_20 | kickoffs | Integer | Number of kickoffs inside the 20 yardline |
kickoffs | kickoffs | Integer | Number of kickoffs |
onside_attempts | kickoffs | Integer | Number of onside kickoff attempts |
onside_successes | kickoffs | Integer | Number of onside kickoff successes |
out_of_bounds | kickoffs | Integer | Number of kickoffs out of bounds |
return_yards | kickoffs | Integer | Number of total return yards on kickoffs |
squib_kicks | kickoffs | Integer | Number of squib kicks |
total_endzone | kickoffs | Integer | Number of total kickoffs into the endzone (touchbacks + endzone kicks) |
touchbacks | kickoffs | Integer | Number of touchbacks |
yards | kickoffs | Integer | Number of kickoff yards |
Game Statistics - Passing (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
air_yards | passing | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
attempts | passing | Integer | Number of pass attempts |
avg_pocket_time | passing | Double | Average time spent in the pocket ex. 2.477 |
avg_yards | passing | Decimal | Average yards per pass attempt ex. 7.22 |
batted_passes | passing | Integer | Number of batted pass attempts |
blitzes | passing | Integer | Number of blitzes |
cmp_pct | passing | Decimal | Completion percentage ex. 78.049 |
completions | passing | Integer | Number of pass completions |
defended_passes | passing | Integer | Number of pass attempts defended |
dropped_passes | passing | Integer | Number of pass attempts dropped |
first_downs | passing | Integer | Number of first downs |
hurries | passing | Integer | Number of pass hurries |
interceptions | passing | Integer | Number of interceptions thrown |
int_touchdowns | passing | Integer | Number of interceptions thrown returned for touchdowns |
knockdowns | passing | Integer | Number of knockdowns |
longest | passing | Integer | Number of yards of longest completed pass |
longest_touchdown | passing | Integer | Number of yards of longest pass for a touchdown |
on_target_throws | passing | Integer | Number of on target throws |
pocket_time | passing | Double | Time spent in the pocket ex. 101.573 |
poor_throws | passing | Integer | Number of poor throws |
rating | passing | Decimal | Passer rating ex. 94.7 |
redzone_attempts | passing | Integer | Number of pass attempts in the red zone |
sack_yards | passing | Integer | Number of sack yards |
sacks | passing | Integer | Number of sacks |
spikes | passing | Integer | Number of spikes |
throw_aways | passing | Integer | Number of throw aways |
touchdowns | passing | Integer | Number of passing touchdowns |
yards | passing | Integer | Number of passing yards |
Game Statistics - Penalties (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
first_downs | penalties | Integer | Number of penalties resulting in a first down |
penalties | penalties | Integer | Number of penalties |
yards | penalties | Integer | Number of penalty yardage |
Game Statistics - Punt Returns (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | punt_returns | Decimal | Average number of yards on punt returns ex. 19.5 |
faircatches | punt_returns | Integer | Number of fair catches on punt returns |
longest | punt_returns | Integer | Number of yards of longest punt return |
longest_touchdown | punt_returns | Integer | Number of yards of longest punt return for a touchdown |
returns | punt_returns | Integer | Number of punt returns |
touchdowns | punt_returns | Integer | Number of punt return touchdowns |
yards | punt_returns | Integer | Number of total punt return yards |
Game Statistics - Punts (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | punts | Integer | Number of punt attempts |
avg_hang_time | punts | Decimal | Average hang time on punts ex. 4.163 |
avg_net_yards | punts | Decimal | Average net yards on punts ex. 28.75 |
avg_yards | punts | Decimal | Average yards on punts ex. 43.75 |
blocked | punts | Integer | Number of punts blocked |
hang_time | punts | Decimal | Total hang time on punts ex. 16.65 |
inside_20 | punts | Integer | Number of punts inside the 20 yardline |
longest | punts | Integer | Number of yards of longest punt |
net_yards | punts | Integer | Number of total net punt yards |
return_yards | punts | Integer | Number of total return punt yards |
out_of_bounds | punts | Integer | Number of punts out of bounds |
return_yards | punts | Integer | Number of total return yards on punts |
touchbacks | punts | Integer | Number of touchbacks |
yards | punts | Integer | Number of punt yards |
Game Statistics - Receiving (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
air_yards | receiving | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
avg_yards | receiving | Decimal | Average yards per reception ex. 7.22 |
broken_tackles | receiving | Integer | Number of receiving broken tackles |
catchable_passes | receiving | Integer | Number of catchable passes |
dropped_passes | receiving | Integer | Number of dropped passes |
first_downs | receiving | Integer | Number of receiving first downs |
longest | receiving | Integer | Number of yards of longest reception |
longest_touchdown | receiving | Integer | Number of yards of longest receiving touchdown |
receptions | receiving | Integer | Number of receptions |
redzone_targets | receiving | Integer | Number of receiving red zone targets |
targets | receiving | Integer | Number of receiving targets |
touchdowns | receiving | Integer | Number of receiving touchdowns |
yards | receiving | Integer | Number of receiving yards |
yards_after_catch | receiving | Integer | Number of receiving yards after the catch |
yards_after_contact | receiving | Integer | Number of receiving yards after contact |
Game Statistics - Rushing (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | rushing | Integer | Number of rushing attempts |
avg_yards | rushing | Decimal | Average yards per rush ex. 3.22 |
broken_tackles | rushing | Integer | Number of rushing broken tackles |
first_downs | rushing | Integer | Number of rushing first downs |
kneel_downs | rushing | Integer | Number of rushing kneel downs |
longest | rushing | Integer | Number of yards of longest rush |
longest_touchdown | rushing | Integer | Number of yards of longest rushing touchdown |
redzone_attempts | rushing | Integer | Number of rushing red zone attempts |
lateral | rushing | Integer | Number of rushing laterals |
scrambles | rushing | Integer | Number of rushing scrambles |
tlost | rushing | Integer | Number of rushing tackles for a loss |
tlost_yards | rushing | Integer | Number of rushing tackles for a loss yardage |
touchdowns | rushing | Integer | Number of rushing touchdowns |
yards | rushing | Integer | Number of rushing yards |
yards_after_contact | rushing | Integer | Number of rushing yards after contact |
Game Statistics - Conversions (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
def_conv_attempts | extra_points | Integer | Number of defensive two-point conversion attempts |
def_conv_successes | extra_points | Integer | Number of successful defensive two-point conversions |
pass_conv_attempts | extra_points | Integer | Number of two-point conversion passing attempts |
pass_conv_successes | extra_points | Integer | Number of successful passing two-point conversions |
rush_conv_attempts | extra_points | Integer | Number of two-point conversion rushing attempts |
rush_conv_successes | extra_points | Integer | Number of successful rushing two-point conversions |
Game Statistics - Defense (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
assists | defense | Integer | Number of defensive assisted tackles *Does not include misc. or special teams tackles |
batted_passes | defense | Integer | Number of batted passes |
blitzes | defense | Integer | Number of blitzes |
combined | defense | Integer | Number of combined (assists + tackles ) defensive tackles*Does not include misc. or special teams tackles |
def_comps | defense | Integer | Number of completed passes with a defensive player covering on the play |
def_targets | defense | Integer | Number of defensive targets |
forced_fumbles | defense | Integer | Number of forced fumbles |
fourth_down_stops | defense | Integer | Number of fourth down stops |
fumble_recoveries | defense | Integer | Number of fumble recoveries |
hurries | defense | Integer | Number of hurries |
interceptions | defense | Integer | Number of interceptions |
knockdowns | defense | Integer | Number of knockdowns |
misc_assists | defense | Integer | Number of miscellaneous assisted tackles. Ex: An assisted tackle by an offensive player on a defensive interception or fumble return |
misc_forced_fumbles | defense | Integer | Number of miscellaneous forced fumbles. Ex: A forced fumble by an offensive player on a defensive interception or fumble return |
misc_fumble_recoveries | defense | Integer | Number of miscellaneous fumble recoveries. Ex: A fumble recovery by an offensive player on a defensive interception or fumble return |
misc_tackles | defense | Integer | Number of miscellaneous tackles. Ex: A solo tackle by an offensive player on a defensive interception or fumble return |
missed_tackles | defense | Integer | Number of missed tackles |
passes_defended | defense | Integer | Number of passes defended |
qb_hits | defense | Integer | Number of hits on the quarterback |
sack_yards | defense | Integer | Number of sack yards |
sacks | defense | Integer | Number of sacks |
safeties | defense | Integer | Number of safeties |
sp_assists | defense | Integer | Number of special teams assisted tackles |
sp_blocks | defense | Integer | Number of blocked kicks/punts |
sp_forced_fumbles | defense | Integer | Number of special teams forced fumbles |
sp_fumble_recoveries | defense | Integer | Number of special teams fumble recoveries |
sp_tackles | defense | Integer | Number of special teams tackles |
tackles | defense | Integer | Number of defensive tackles *Does not include misc. or special teams tackles |
three_and_outs_forced | defense | Integer | Number of three and outs forced |
tloss | defense | Integer | Number of tackles for a loss |
tloss_yards | defense | Integer | Number of tackles for a loss yardage |
Game Statistics - Efficiency (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | efficiency - thirddown | Integer | Number of third down attempts |
successes | efficiency - thirddown | Integer | Number of third down successes |
pct | efficiency - thirddown | Decimal | Third down conversion percentage ex. 61.538 |
attempts | efficiency - fourthdown | Integer | Number of fourth down attempts |
successes | efficiency - fourthdown | Integer | Number of fourth down successes |
pct | efficiency - fourthdown | Decimal | Fourth down conversion percentage ex. 50.0 |
attempts | efficiency - goaltogo | Integer | Number of goal-to-go attempts |
successes | efficiency - goaltogo | Integer | Number of goal-to-go successes |
pct | efficiency - goaltogo | Decimal | Goal-to-go conversion percentage ex. 100.0 |
attempts | efficiency - redzone | Integer | Number of red zone attempts |
successes | efficiency - redzone | Integer | Number of red zone successes |
pct | efficiency - redzone | Decimal | Red zone conversion percentage ex. 80.0 |
Game Statistics - Extra Points (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
kick_attempts | extra_points | Integer | Number of attempted extra points |
kick_blocked | extra_points | Integer | Number of blocked extra points |
kick_made | extra_points | Integer | Number of made extra points |
missed | extra_points | Integer | Number of missed extra points |
Game Statistics - Field Goals (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | field_goals | Integer | Number of attempted field goals |
attempts_19 | field_goals | Integer | Number of attempted field goals between 1-19 yards |
attempts_29 | field_goals | Integer | Number of attempted field goals between 20-29 yards |
attempts_39 | field_goals | Integer | Number of attempted field goals between 30-39 yards |
attempts_49 | field_goals | Integer | Number of attempted field goals between 40-49 yards |
attempts_50 | field_goals | Integer | Number of attempted field goals of 50 yards or more |
avg_yards | field_goals | Decimal | Average number of yards on attempted field goals ex. 38.5 |
blocked | field_goals | Integer | Number of blocked field goals |
longest | field_goals | Integer | Number of yards of longest made field goal |
made | field_goals - player | Integer | Number of made field goals |
made_19 | field_goals | Integer | Number of successful field goals between 1-19 yards |
made_29 | field_goals | Integer | Number of successful field goals between 20-29 yards |
made_39 | field_goals | Integer | Number of successful field goals between 30-39 yards |
made_49 | field_goals | Integer | Number of successful field goals between 40-49 yards |
made_50 | field_goals | Integer | Number of successful field goals of 50 yards or more |
missed | field_goals | Integer | Number of missed field goals |
yards | field_goals | Integer | Number of total yards on successful field goals |
Game Statistics - First Downs (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
pass | first_downs | Integer | Number of passing first downs |
penalty | first_downs | Integer | Number of first downs due to penalty |
rush | first_downs | Integer | Number of rushing first downs |
total | first_downs | Integer | Number of total first downs |
Game Statistics - Fumbles (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
ez_rec_tds | fumbles | Integer | Number of end zone fumble recovery touchdowns |
forced_fumbles | fumbles | Integer | Number of forced fumbles |
fumbles | fumbles | Integer | Number of fumbles |
lost_fumbles | fumbles | Integer | Number of lost fumbles |
opp_rec | fumbles | Integer | Number of opponent fumble recoveries |
opp_rec_tds | fumbles | Integer | Number of opponent fumble recovery touchdowns |
opp_rec_yards | fumbles | Integer | Number of opponent fumble recovery yards |
out_of_bounds | fumbles | Integer | Number of opponent fumbles out of bounds |
own_rec | fumbles | Integer | Number of own fumble recoveries |
own_rec_tds | fumbles | Integer | Number of own fumble recovery touchdowns |
own_rec_yards | fumbles | Integer | Number of own fumble recovery yards |
Game Statistics - Interception Returns (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | int_returns | Decimal | Average number of yards on interception returns ex. 38.5 |
longest | int_returns | Integer | Number of yards of longest interception return |
longest_touchdown | int_returns | Integer | Number of yards of longest interception return for a touchdown |
returns | int_returns | Integer | Number of interception returns |
touchdowns | int_returns | Integer | Number of interception return touchdowns |
yards | int_returns | Integer | Number of total interception return yards |
interceptions | interceptions | Integer | Number of interceptions |
return_yards | interceptions | Integer | Number of interception return yards |
returned | interceptions | Integer | Number of interceptions returned |
Game Statistics - Kick Returns (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | kick_returns | Decimal | Average number of yards on kick returns ex. 19.5 |
faircatches | kick_returns | Integer | Number of fair catches on kick returns |
longest | kick_returns | Integer | Number of yards of longest kick return |
longest_touchdown | kick_returns | Integer | Number of yards of longest kick return for a touchdown |
returns | kick_returns | Integer | Number of kick returns |
touchdowns | kick_returns | Integer | Number of kick return touchdowns |
yards | kick_returns | Integer | Number of total kick return yards |
Game Statistics - Kickoffs (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
endzone | kickoffs | Integer | Number of kickoffs into the endzone |
inside_20 | kickoffs | Integer | Number of kickoffs inside the 20 yardline |
kickoffs | kickoffs | Integer | Number of kickoffs |
out_of_bounds | kickoffs | Integer | Number of kickoffs out of bounds |
return_yards | kickoffs | Integer | Number of total return yards on kickoffs |
total_endzone | kickoffs | Integer | Number of total kickoffs into the endzone (touchbacks + endzone kicks) |
touchbacks | kickoffs | Integer | Number of touchbacks |
yards | kickoffs | Integer | Number of kickoff yards |
Game Statistics - Miscellaneous Returns (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
blk_fg_touchdowns | misc_returns | Integer | Number of blocked field goals returned for touchdowns |
blk_punt_touchdowns | misc_returns | Integer | Number of blocked punts returned for touchdowns |
ez_rec_touchdowns | misc_returns | Integer | Number of end zone recovery touchdowns |
fg_touchdowns | misc_returns | Integer | Number of field goal attempts returned for touchdowns |
returns | misc_returns | Integer | Number of miscellaneous returns |
touchdowns | misc_returns | Integer | Number of miscellaneous returns for touchdowns |
yards | misc_returns | Integer | Number of miscellaneous return yardage |
Game Statistics - Passing (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
air_yards | passing | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
attempts | passing | Integer | Number of pass attempts |
avg_pocket_time | passing | Double | Average time spent in the pocket ex. 2.477 |
avg_yards | passing | Decimal | Average yards per pass attempt ex. 7.22 |
batted_passes | passing | Integer | Number of batted pass attempts |
blitzes | passing | Integer | Number of blitzes |
cmp_pct | passing | Decimal | Completion percentage ex. 78.049 |
completions | passing | Integer | Number of pass completions |
defended_passes | passing | Integer | Number of pass attempts defended |
dropped_passes | passing | Integer | Number of pass attempts dropped |
first_downs | passing | Integer | Number of first downs |
hurries | passing | Integer | Number of pass hurries |
interceptions | passing | Integer | Number of interceptions thrown |
int_touchdowns | passing | Integer | Number of interceptions thrown returned for touchdowns |
knockdowns | passing | Integer | Number of knockdowns |
longest | passing | Integer | Number of yards of longest completed pass |
longest_touchdown | passing | Integer | Number of yards of longest pass for a touchdown |
net_yards | passing | Integer | Number of net yards passing |
on_target_throws | passing | Integer | Number of on target throws |
pocket_time | passing | Double | Time spent in the pocket ex. 101.573 |
poor_throws | passing | Integer | Number of poor throws |
rating | passing | Decimal | Passer rating ex. 94.7 |
redzone_attempts | passing | Integer | Number of pass attempts in the red zone |
sack_yards | passing | Integer | Number of sack yards |
sacks | passing | Integer | Number of sacks |
spikes | passing | Integer | Number of spikes |
throw_aways | passing | Integer | Number of throw aways |
touchdowns | passing | Integer | Number of passing touchdowns |
yards | passing | Integer | Number of passing yards |
Game Statistics - Penalties (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
first_downs | penalties | Integer | Number of penalties resulting in a first down |
penalties | penalties | Integer | Number of penalties |
yards | penalties | Integer | Number of penalty yardage |
Game Statistics - Punt Returns (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_yards | punt_returns | Decimal | Average number of yards on punt returns ex. 19.5 |
faircatches | punt_returns | Integer | Number of fair catches on punt returns |
longest | punt_returns | Integer | Number of yards of longest punt return |
longest_touchdown | punt_returns | Integer | Number of yards of longest punt return for a touchdown |
returns | punt_returns | Integer | Number of punt returns |
touchdowns | punt_returns | Integer | Number of punt return touchdowns |
yards | punt_returns | Integer | Number of total punt return yards |
Game Statistics - Punts (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | punts | Integer | Number of punt attempts |
avg_hang_time | punts | Decimal | Average hang time on punts ex. 4.163 |
avg_net_yards | punts | Decimal | Average net yards on punts ex. 28.75 |
avg_yards | punts | Decimal | Average yards on punts ex. 43.75 |
blocked | punts | Integer | Number of punts blocked |
hang_time | punts | Decimal | Total hang time on punts ex. 16.65 |
inside_20 | punts | Integer | Number of punts inside the 20 yardline |
longest | punts | Integer | Number of yards of longest punt |
net_yards | punts | Integer | Number of total net punt yards |
return_yards | punts | Integer | Number of total return punt yards |
out_of_bounds | punts | Integer | Number of punts out of bounds |
return_yards | punts | Integer | Number of total return yards on punts |
touchbacks | punts | Integer | Number of touchbacks |
yards | punts | Integer | Number of punt yards |
Game Statistics - Receiving (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
air_yards | receiving | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
avg_yards | receiving | Decimal | Average yards per reception ex. 7.22 |
broken_tackles | receiving | Integer | Number of receiving broken tackles |
catchable_passes | receiving | Integer | Number of catchable passes |
dropped_passes | receiving | Integer | Number of dropped passes |
first_downs | receiving | Integer | Number of receiving first downs |
longest | receiving | Integer | Number of yards of longest reception |
longest_touchdown | receiving | Integer | Number of yards of longest receiving touchdown |
receptions | receiving | Integer | Number of receptions |
redzone_targets | receiving | Integer | Number of receiving red zone targets |
targets | receiving | Integer | Number of receiving targets |
touchdowns | receiving | Integer | Number of receiving touchdowns |
yards | receiving | Integer | Number of receiving yards |
yards_after_catch | receiving | Integer | Number of receiving yards after the catch |
yards_after_contact | receiving | Integer | Number of receiving yards after contact |
Game Statistics - Rushing (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempts | rushing | Integer | Number of rushing attempts |
avg_yards | rushing | Decimal | Average yards per rush ex. 3.22 |
broken_tackles | rushing | Integer | Number of rushing broken tackles |
first_downs | rushing | Integer | Number of rushing first downs |
kneel_downs | rushing | Integer | Number of rushing kneel downs |
longest | rushing | Integer | Number of yards of longest rush |
longest_touchdown | rushing | Integer | Number of yards of longest rushing touchdown |
redzone_attempts | rushing | Integer | Number of rushing red zone attempts |
scrambles | rushing | Integer | Number of rushing scrambles |
tlost | rushing | Integer | Number of rushing tackles for a loss |
tlost_yards | rushing | Integer | Number of rushing tackles for a loss yardage |
touchdowns | rushing | Integer | Number of rushing touchdowns |
yards | rushing | Integer | Number of rushing yards |
yards_after_contact | rushing | Integer | Number of rushing yards after contact |
Game Statistics - Touchdowns (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
fumble_return | touchdowns | Integer | Number of fumble return touchdowns |
int_return | touchdowns | Integer | Number of interception return touchdowns |
kick_return | touchdowns | Integer | Number of kick return touchdowns |
other | touchdowns | Integer | Number of touchdowns outside of other categories. Common examples are blocked kicks or punts returned for scores. |
pass | touchdowns | Integer | Number of passing touchdowns |
punt_return | touchdowns | Integer | Number of punt return touchdowns |
rush | touchdowns | Integer | Number of rushing touchdowns |
total | touchdowns | Integer | Number of total touchdowns |
total_return | touchdowns | Integer | Number of total return touchdowns |
Game Statistics - Team Summary:
Attribute | Parent Element | Type | Description |
---|---|---|---|
avg_gain | summary | Decimal | Average yards per play ex. 7.6 |
fumbles | summary | Integer | Number of fumbles |
lost_fumbles | summary | Integer | Number of fumbles lost |
penalties | summary | Integer | Number of penalties |
penalty_yards | summary | Integer | Number of penalty yards |
play_count | summary | Integer | Number of offensive plays |
possession_time | summary | Integer | Time of possession ex. 36:38 |
return_yards | summary | Integer | Number of return yards |
rush_plays | summary | Integer | Number of rushing plays |
safeties | summary | Integer | Number of safeties |
total_yards | summary | Integer | Number of total yards |
turnovers | summary | Integer | Number of turnovers |
League:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | summary - season | GUID | Unique season ID ex. 75749c10-56c1-4ae0-9d1e-2689708debdf |
name | summary - season | String | Name of the seasonPRE ,REG ,PST |
type | summary - season | String | Type of the seasonPRE ,REG ,PST |
year | summary - season | Integer | Year of the season |
id | summary - week | GUID | Unique week ID ex. 57b447ce-bc66-47f7-9760-89d328d3db9f |
sequence | summary - week | Integer | Week sequence number |
title | summary - week | String | Week title |
Metadata:
Attribute | Parent Element | Type | Description |
---|---|---|---|
league | metadata | String | Alias of a league ex. nfl |
locale | metadata | String | Language code ex. en (English) |
match | metadata | GUID | Unique ID(s) of a game ex. sd:match:1a57777c-7c57-43fa-bf08-66bffc204fd1,sr:match:33623353 |
operation | metadata | String | Operation of an updateupdate , delete |
participant | metadata | GUID | Unique ID(s) of a team or player ex. sd:team:1f6dcffb-9823-43cd-9ff4-e7a8466749b5,sr:competitor:4429 |
status | metadata | String | The status of a gamescheduled , inprogress , complete , closed , wdelay , fdelay , odelay , canceled , unnecessary , if-necessary , postponed , suspended , maintenance See our NFL FAQ for game status descriptions |
version | metadata | String | Version of the API ex. v7 |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
name | player | String | Full name of a player ex. George Kittle |
id | player | GUID | Unique ID of a player ex. 7e648a0b-fdc8-4661-a587-5826f2cac11b |
jersey | player | String | Jersey number of a player |
position | player | String | Position of an NFL player |
sr_id | player | String | Unique Sportradar player ID ex. sr:player:828235 |
Standings:
Attribute | Parent Element | Type | Description |
---|---|---|---|
losses | home / away - record | Integer | Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome |
ties | home / away - record | Integer | Number of team ties year-to-date before the game. Record is updated post-game based on the game outcome |
wins | home / away - record | Integer | Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | team | String | Team alias ex. MIN (Minnesota) |
id | team | GUID | Unique ID of a team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
market | team | String | Team market name ex. Minnesota |
name | team | String | Team name ex. Vikings |
sr_id | team | String | Unique Sportradar ID of a team ex. sr:competitor:4324 |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
address | summary - venue | String | Address of a venue ex. 900 S 5th Street |
capacity | summary - venue | Integer | Capacity of a venue ex. 72220 |
city | summary - venue | String | City of a venue ex. Minneapolis |
country | summary - venue | String | Country of a venue ex. USA |
id | summary - venue | GUID | Unique ID of a venue ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346 |
lat | summary - venue - location | Decimal | Latitude of a venue ex. 29.684735 |
lng | summary - venue - location | Decimal | Longitude of a venue ex. -95.410725 |
name | summary - venue | String | Name of a venue ex. U.S. Bank Stadium |
roof_type | summary - venue | String | Roof type of a venueoutdoor ,dome ,retractable_dome |
sr_id | summary - venue | String | Unique Sportradar venue ID ex. sr:venue:2402 |
state | summary - venue | String | State of a venue ex. MN |
surface | summary - venue | String | Surface type of a venueturf ,artificial |
zip | summary - venue | Integer | ZIP code of a venue ex. 77054 |