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} |
Replace placeholders with the following query parameters:
Parameter | Description |
---|---|
access_level | Defines the access level of your API key as Production (production), or Trial (trial). |
language_code | Optional code for supported languages: en (English) or translations (Any other language translations. See optional query string parameters for locale.) |
your_api_key | Your API key. |
Optional Query String Parameters
In addition to the URL parameters listed above, you can filter the Events information with one or more of the following optional query string parameters.
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.
Replace placeholders with the following query parameters:
Parameter | Description |
---|---|
locale | Locale expressed as 2 letter code: locale={language_code} Example: locale=en |
match | Match id expressed as: sd:match:{match_id}. Example: match_id=sd:match:4d1c4eb9-69d4-46fc-a42b-12be98227964 |
participant | Team or player id expressed as: sd:team:{team_id} or sd:player:{player_id} Examples: sd:team:82cf9565-6eb9-4f01-bdbd-5aa0d472fcd9 or sd:player:e3181493-6a2a-4e95-aa6f-3fc1ddeb7512 |
status | Status type expressed as: inprogress or 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.
Data Points
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 assisted tackles |
batted_passes | defense | Integer | Number of batted passes |
blitzes | defense | Integer | Number of blitzes |
combined | defense | Integer | Number of combined 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 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 assisted tackles |
batted_passes | defense | Integer | Number of batted passes |
blitzes | defense | Integer | Number of blitzes |
combined | defense | Integer | Number of combined 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 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 |
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. v6 |
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 |
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 |