Integration GuidesReference Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

Push Statistics

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:

ParameterDescription
access_levelDefines the access level of your API key as Production (production), or Trial (trial).
language_codeOptional code for supported languages: en (English) or translations (Any other language translations. See optional query string parameters for locale.)
your_api_keyYour 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:

ParameterDescription
localeLocale expressed as 2 letter code: locale={language_code}
Example: locale=en
matchMatch id expressed as: sd:match:{match_id}.
Example: match_id=sd:match:4d1c4eb9-69d4-46fc-a42b-12be98227964
participantTeam 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
statusStatus 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. 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:
AttributeParent ElementTypeDescription
attendancepayloadIntegerAttendance of a game
ex. 73242
remaining_challengesawayIntegerAway team challenges remaining
remaining_timeoutsawayIntegerAway team timeouts remaining
used_challengesawayIntegerAway team challenges used
used_timeoutsawayIntegerAway team timeouts used
pointsawayIntegerAway team total points
clockpayloadStringClock value of the game
ex. 12:37
remaining_challengeshomeIntegerHome team challenges remaining
remaining_timeoutshomeIntegerHome team timeouts remaining
used_challengeshomeIntegerHome team challenges used
used_timeoutshomeIntegerHome team timeouts used
pointshomeIntegerHome team total points
quarterpayloadIntegerQuarter number of the game
Game:
AttributeParent ElementTypeDescription
aliasawayStringAway team alias
ex. MIN (Minnesota)
idawayGUIDUnique ID of the away team
ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724
marketawayStringAway team market name
ex. Minnesota
nameawayStringAway team name
ex. Vikings
sr_idawayStringUnique Sportradar ID of the away team
ex. sr:competitor:4376
conference_gamepayloadBooleanSignifies an in-Conference matchup
ex. (NFC vs. NFC)
coveragepayloadStringCoverage level of a game
full
durationpayloadStringDuration of the game
ex. 2:52
entry_modepayloadStringType of data entry for the game
LDE (Live Data Entry)
aliashomeStringHome team alias
ex. GB (Green Bay)
idhomeGUIDUnique ID of the home team
ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8
markethomeStringHome team market name
ex. Green Bay
namehomeStringHome team name
ex. Packers
sr_idhomeStringUnique Sportradar ID of the home team
ex. sr:competitor:4391
idpayloadGUIDUnique ID of a game
ex. 13025660-aa95-4885-b33e-3a3554d4c4c3
neutral_sitepayloadBooleanSignifies a game is held at a neutral site when true
scheduledpayloadDate/TimeScheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00
sr_idpayloadStringUnique Sportradar ID of a game
ex. sr:match:33623305
statuspayloadStringGame status
scheduled, created, inprogress, complete, closed, cancelled, delayed, suspended, postponed, time-tbd, if necessary, unnecessary

See our NFL FAQ for game status descriptions
awaytime_zonesStringTime zone of the away team
ex. US/Pacific
hometime_zonesStringTime zone of the home team
ex. US/Eastern
venuetime_zonesStringTime zone of the venue
ex. US/Eastern
titlepayloadStringGame title
ex. NFC Championship
wx_conditionpayloadStringWeather conditions for a game
ex. Partly cloudy
wx_humiditypayloadByteHumidity conditions for a game
ex. 44
wx_temppayloadByteTemperature of a game in Fahrenheit
ex. 57
wx_wind_directionpayloadStringWind direction for a game
ex. N
wx_wind_speedpayloadByteWind speed for a game in MPH
Game Statistics - Conversions (Player):
AttributeParent ElementTypeDescription
attemptsconversionsIntegerNumber of two-point conversion attempts
categoryconversionsStringCategory of conversion
pass, receive, rush, turnover
successesconversionsIntegerNumber of successful two-point conversions
Game Statistics - Defense (Player):
AttributeParent ElementTypeDescription
assistsdefenseIntegerNumber of assisted tackles
batted_passesdefenseIntegerNumber of batted passes
blitzesdefenseIntegerNumber of blitzes
combineddefenseIntegerNumber of combined tackles
def_compsdefenseIntegerNumber of completed passes with a defensive player covering on the play
def_targetsdefenseIntegerNumber of defensive targets
forced_fumblesdefenseIntegerNumber of forced fumbles
fumble_recoveriesdefenseIntegerNumber of fumble recoveries
hurriesdefenseIntegerNumber of hurries
interceptionsdefenseIntegerNumber of interceptions
knockdownsdefenseIntegerNumber of knockdowns
misc_assistsdefenseIntegerNumber of miscellaneous assisted tackles.

Ex: An assisted tackle by an offensive player on a defensive interception or fumble return
misc_forced_fumblesdefenseIntegerNumber of miscellaneous forced fumbles.

Ex: A forced fumble by an offensive player on a defensive interception or fumble return
misc_fumble_recoveriesdefenseIntegerNumber of miscellaneous fumble recoveries.

Ex: A fumble recovery by an offensive player on a defensive interception or fumble return
misc_tacklesdefenseIntegerNumber of miscellaneous tackles.

Ex: A solo tackle by an offensive player on a defensive interception or fumble return
missed_tacklesdefenseIntegerNumber of missed tackles
passes_defendeddefenseIntegerNumber of passes defended
qb_hitsdefenseIntegerNumber of hits on the quarterback
sack_yardsdefenseIntegerNumber of sack yards
sacksdefenseIntegerNumber of sacks
safetiesdefenseIntegerNumber of safeties
sp_assistsdefenseIntegerNumber of special teams assisted tackles
sp_blocksdefenseIntegerNumber of blocked kicks/punts
sp_forced_fumblesdefenseIntegerNumber of special teams forced fumbles
sp_fumble_recoveriesdefenseIntegerNumber of special teams fumble recoveries
sp_tacklesdefenseIntegerNumber of special teams tackles
tacklesdefenseIntegerNumber of tackles
tlossdefenseIntegerNumber of tackles for a loss
tloss_yardsdefenseIntegerNumber of tackles for a loss yardage
Game Statistics - Extra Points (Player):
AttributeParent ElementTypeDescription
attemptsextra_pointsIntegerNumber of attempted extra points
blockedextra_pointsIntegerNumber of blocked extra points
madeextra_pointsIntegerNumber of made extra points
missedextra_pointsIntegerNumber of missed extra points
percentextra_pointsDecimalExtra point percentage
ex. 75.0
Game Statistics - Field Goals (Player):
AttributeParent ElementTypeDescription
attemptsfield_goalsIntegerNumber of attempted field goals
attempts_19field_goalsIntegerNumber of attempted field goals between 1-19 yards
attempts_29field_goalsIntegerNumber of attempted field goals between 20-29 yards
attempts_39field_goalsIntegerNumber of attempted field goals between 30-39 yards
attempts_49field_goalsIntegerNumber of attempted field goals between 40-49 yards
attempts_50field_goalsIntegerNumber of attempted field goals of 50 yards or more
avg_yardsfield_goalsDecimalAverage number of yards on attempted field goals
ex. 38.5
blockedfield_goalsIntegerNumber of blocked field goals
longestfield_goalsIntegerNumber of yards of longest made field goal
madefield_goals - playerIntegerNumber of made field goals
made_19field_goalsIntegerNumber of successful field goals between 1-19 yards
made_29field_goalsIntegerNumber of successful field goals between 20-29 yards
made_39field_goalsIntegerNumber of successful field goals between 30-39 yards
made_49field_goalsIntegerNumber of successful field goals between 40-49 yards
made_50field_goalsIntegerNumber of successful field goals of 50 yards or more
missedfield_goalsIntegerNumber of missed field goals
pctfield_goalsDecimalField goal percentage
ex. 75.0
yardsfield_goalsIntegerNumber of total yards on successful field goals
Game Statistics - Fumbles (Player):
AttributeParent ElementTypeDescription
ez_rec_tdsfumblesIntegerNumber of end zone fumble recovery touchdowns
forced_fumblesfumblesIntegerNumber of forced fumbles
fumblesfumblesIntegerNumber of fumbles
lost_fumblesfumblesIntegerNumber of lost fumbles
opp_recfumblesIntegerNumber of opponent fumble recoveries
opp_rec_tdsfumblesIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumblesIntegerNumber of opponent fumble recovery yards
out_of_boundsfumblesIntegerNumber of opponent fumbles out of bounds
own_recfumblesIntegerNumber of own fumble recoveries
own_rec_tdsfumblesIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumblesIntegerNumber of own fumble recovery yards
Game Statistics - Interception Returns (Player):
AttributeParent ElementTypeDescription
avg_yardsint_returnsDecimalAverage number of yards on interception returns
ex. 38.5
longestint_returnsIntegerNumber of yards of longest interception return
longest_touchdownint_returnsIntegerNumber of yards of longest interception return for a touchdown
returnsint_returnsIntegerNumber of interception returns
touchdownsint_returnIntegerNumber of interception return touchdowns
yardsint_returnsIntegerNumber of total interception return yards
Game Statistics - Kick Returns (Player):
AttributeParent ElementTypeDescription
avg_yardskick_returnsDecimalAverage number of yards on kick returns
ex. 19.5
faircatcheskick_returnsIntegerNumber of fair catches on kick returns
longestkick_returnsIntegerNumber of yards of longest kick return
longest_touchdownkick_returnsIntegerNumber of yards of longest kick return for a touchdown
returnskick_returnsIntegerNumber of kick returns
touchdownskick_returnsIntegerNumber of kick return touchdowns
yardskick_returnsIntegerNumber of total kick return yards
Game Statistics - Kickoffs (Player):
AttributeParent ElementTypeDescription
endzonekickoffsIntegerNumber of kickoffs into the endzone
inside_20kickoffsIntegerNumber of kickoffs inside the 20 yardline
kickoffskickoffsIntegerNumber of kickoffs
onside_attemptskickoffsIntegerNumber of onside kickoff attempts
onside_successeskickoffsIntegerNumber of onside kickoff successes
out_of_boundskickoffsIntegerNumber of kickoffs out of bounds
return_yardskickoffsIntegerNumber of total return yards on kickoffs
squib_kickskickoffsIntegerNumber of squib kicks
total_endzonekickoffsIntegerNumber of total kickoffs into the endzone (touchbacks + endzone kicks)
touchbackskickoffsIntegerNumber of touchbacks
yardskickoffsIntegerNumber of kickoff yards
Game Statistics - Passing (Player):
AttributeParent ElementTypeDescription
air_yardspassingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
attemptspassingIntegerNumber of pass attempts
avg_pocket_timepassingDoubleAverage time spent in the pocket
ex. 2.477
avg_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
batted_passespassingIntegerNumber of batted pass attempts
blitzespassingIntegerNumber of blitzes
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
defended_passespassingIntegerNumber of pass attempts defended
dropped_passespassingIntegerNumber of pass attempts dropped
first_downspassingIntegerNumber of first downs
hurriespassingIntegerNumber of pass hurries
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
knockdownspassingIntegerNumber of knockdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
on_target_throwspassingIntegerNumber of on target throws
pocket_timepassingDoubleTime spent in the pocket
ex. 101.573
poor_throwspassingIntegerNumber of poor throws
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
spikespassingIntegerNumber of spikes
throw_awayspassingIntegerNumber of throw aways
touchdownspassingIntegerNumber of passing touchdowns
yardspassingIntegerNumber of passing yards
Game Statistics - Penalties (Player):
AttributeParent ElementTypeDescription
first_downspenaltiesIntegerNumber of penalties resulting in a first down
penaltiespenaltiesIntegerNumber of penalties
yardspenaltiesIntegerNumber of penalty yardage
Game Statistics - Punt Returns (Player):
AttributeParent ElementTypeDescription
avg_yardspunt_returnsDecimalAverage number of yards on punt returns
ex. 19.5
faircatchespunt_returnsIntegerNumber of fair catches on punt returns
longestpunt_returnsIntegerNumber of yards of longest punt return
longest_touchdownpunt_returnsIntegerNumber of yards of longest punt return for a touchdown
returnspunt_returnsIntegerNumber of punt returns
touchdownspunt_returnsIntegerNumber of punt return touchdowns
yardspunt_returnsIntegerNumber of total punt return yards
Game Statistics - Punts (Player):
AttributeParent ElementTypeDescription
attemptspuntsIntegerNumber of punt attempts
avg_hang_timepuntsDecimalAverage hang time on punts
ex. 4.163
avg_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
hang_timepuntsDecimalTotal hang time on punts
ex. 16.65
inside_20puntsIntegerNumber of punts inside the 20 yardline
longestpuntsIntegerNumber of yards of longest punt
net_yardspuntsIntegerNumber of total net punt yards
return_yardspuntsIntegerNumber of total return punt yards
out_of_boundspuntsIntegerNumber of punts out of bounds
return_yardspuntsIntegerNumber of total return yards on punts
touchbackspuntsIntegerNumber of touchbacks
yardspuntsIntegerNumber of punt yards
Game Statistics - Receiving (Player):
AttributeParent ElementTypeDescription
air_yardsreceivingIntegerNumber 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_yardsreceivingDecimalAverage yards per reception
ex. 7.22
broken_tacklesreceivingIntegerNumber of receiving broken tackles
catchable_passesreceivingIntegerNumber of catchable passes
dropped_passesreceivingIntegerNumber of dropped passes
first_downsreceivingIntegerNumber of receiving first downs
longestreceivingIntegerNumber of yards of longest reception
longest_touchdownreceivingIntegerNumber of yards of longest receiving touchdown
receptionsreceivingIntegerNumber of receptions
redzone_targetsreceivingIntegerNumber of receiving red zone targets
targetsreceivingIntegerNumber of receiving targets
touchdownsreceivingIntegerNumber of receiving touchdowns
yardsreceivingIntegerNumber of receiving yards
yards_after_catchreceivingIntegerNumber of receiving yards after the catch
yards_after_contactreceivingIntegerNumber of receiving yards after contact
Game Statistics - Rushing (Player):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
broken_tacklesrushingIntegerNumber of rushing broken tackles
first_downsrushingIntegerNumber of rushing first downs
kneel_downsrushingIntegerNumber of rushing kneel downs
longestrushingIntegerNumber of yards of longest rush
longest_touchdownrushingIntegerNumber of yards of longest rushing touchdown
redzone_attemptsrushingIntegerNumber of rushing red zone attempts
lateralrushingIntegerNumber of rushing laterals
scramblesrushingIntegerNumber of rushing scrambles
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
yards_after_contactrushingIntegerNumber of rushing yards after contact
Game Statistics - Conversions (Team):
AttributeParent ElementTypeDescription
def_conv_attemptsextra_pointsIntegerNumber of defensive two-point conversion attempts
def_conv_successesextra_pointsIntegerNumber of successful defensive two-point conversions
pass_conv_attemptsextra_pointsIntegerNumber of two-point conversion passing attempts
pass_conv_successesextra_pointsIntegerNumber of successful passing two-point conversions
rush_conv_attemptsextra_pointsIntegerNumber of two-point conversion rushing attempts
rush_conv_successesextra_pointsIntegerNumber of successful rushing two-point conversions
Game Statistics - Defense (Team):
AttributeParent ElementTypeDescription
assistsdefenseIntegerNumber of assisted tackles
batted_passesdefenseIntegerNumber of batted passes
blitzesdefenseIntegerNumber of blitzes
combineddefenseIntegerNumber of combined tackles
def_compsdefenseIntegerNumber of completed passes with a defensive player covering on the play
def_targetsdefenseIntegerNumber of defensive targets
forced_fumblesdefenseIntegerNumber of forced fumbles
fourth_down_stopsdefenseIntegerNumber of fourth down stops
fumble_recoveriesdefenseIntegerNumber of fumble recoveries
hurriesdefenseIntegerNumber of hurries
interceptionsdefenseIntegerNumber of interceptions
knockdownsdefenseIntegerNumber of knockdowns
misc_assistsdefenseIntegerNumber of miscellaneous assisted tackles.

Ex: An assisted tackle by an offensive player on a defensive interception or fumble return
misc_forced_fumblesdefenseIntegerNumber of miscellaneous forced fumbles.

Ex: A forced fumble by an offensive player on a defensive interception or fumble return
misc_fumble_recoveriesdefenseIntegerNumber of miscellaneous fumble recoveries.

Ex: A fumble recovery by an offensive player on a defensive interception or fumble return
misc_tacklesdefenseIntegerNumber of miscellaneous tackles.

Ex: A solo tackle by an offensive player on a defensive interception or fumble return
missed_tacklesdefenseIntegerNumber of missed tackles
passes_defendeddefenseIntegerNumber of passes defended
qb_hitsdefenseIntegerNumber of hits on the quarterback
sack_yardsdefenseIntegerNumber of sack yards
sacksdefenseIntegerNumber of sacks
safetiesdefenseIntegerNumber of safeties
sp_assistsdefenseIntegerNumber of special teams assisted tackles
sp_blocksdefenseIntegerNumber of blocked kicks/punts
sp_forced_fumblesdefenseIntegerNumber of special teams forced fumbles
sp_fumble_recoveriesdefenseIntegerNumber of special teams fumble recoveries
sp_tacklesdefenseIntegerNumber of special teams tackles
tacklesdefenseIntegerNumber of tackles
three_and_outs_forceddefenseIntegerNumber of three and outs forced
tlossdefenseIntegerNumber of tackles for a loss
tloss_yardsdefenseIntegerNumber of tackles for a loss yardage
Game Statistics - Efficiency (Team):
AttributeParent ElementTypeDescription
attemptsefficiency - thirddownIntegerNumber of third down attempts
successesefficiency - thirddownIntegerNumber of third down successes
pctefficiency - thirddownDecimalThird down conversion percentage
ex. 61.538
attemptsefficiency - fourthdownIntegerNumber of fourth down attempts
successesefficiency - fourthdownIntegerNumber of fourth down successes
pctefficiency - fourthdownDecimalFourth down conversion percentage
ex. 50.0
attemptsefficiency - goaltogoIntegerNumber of goal-to-go attempts
successesefficiency - goaltogoIntegerNumber of goal-to-go successes
pctefficiency - goaltogoDecimalGoal-to-go conversion percentage
ex. 100.0
attemptsefficiency - redzoneIntegerNumber of red zone attempts
successesefficiency - redzoneIntegerNumber of red zone successes
pctefficiency - redzoneDecimalRed zone conversion percentage
ex. 80.0
Game Statistics - Extra Points (Team):
AttributeParent ElementTypeDescription
kick_attemptsextra_pointsIntegerNumber of attempted extra points
kick_blockedextra_pointsIntegerNumber of blocked extra points
kick_madeextra_pointsIntegerNumber of made extra points
missedextra_pointsIntegerNumber of missed extra points
Game Statistics - Field Goals (Team):
AttributeParent ElementTypeDescription
attemptsfield_goalsIntegerNumber of attempted field goals
attempts_19field_goalsIntegerNumber of attempted field goals between 1-19 yards
attempts_29field_goalsIntegerNumber of attempted field goals between 20-29 yards
attempts_39field_goalsIntegerNumber of attempted field goals between 30-39 yards
attempts_49field_goalsIntegerNumber of attempted field goals between 40-49 yards
attempts_50field_goalsIntegerNumber of attempted field goals of 50 yards or more
avg_yardsfield_goalsDecimalAverage number of yards on attempted field goals
ex. 38.5
blockedfield_goalsIntegerNumber of blocked field goals
longestfield_goalsIntegerNumber of yards of longest made field goal
madefield_goals - playerIntegerNumber of made field goals
made_19field_goalsIntegerNumber of successful field goals between 1-19 yards
made_29field_goalsIntegerNumber of successful field goals between 20-29 yards
made_39field_goalsIntegerNumber of successful field goals between 30-39 yards
made_49field_goalsIntegerNumber of successful field goals between 40-49 yards
made_50field_goalsIntegerNumber of successful field goals of 50 yards or more
missedfield_goalsIntegerNumber of missed field goals
yardsfield_goalsIntegerNumber of total yards on successful field goals
Game Statistics - First Downs (Team):
AttributeParent ElementTypeDescription
passfirst_downsIntegerNumber of passing first downs
penaltyfirst_downsIntegerNumber of first downs due to penalty
rushfirst_downsIntegerNumber of rushing first downs
totalfirst_downsIntegerNumber of total first downs
Game Statistics - Fumbles (Team):
AttributeParent ElementTypeDescription
ez_rec_tdsfumblesIntegerNumber of end zone fumble recovery touchdowns
forced_fumblesfumblesIntegerNumber of forced fumbles
fumblesfumblesIntegerNumber of fumbles
lost_fumblesfumblesIntegerNumber of lost fumbles
opp_recfumblesIntegerNumber of opponent fumble recoveries
opp_rec_tdsfumblesIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumblesIntegerNumber of opponent fumble recovery yards
out_of_boundsfumblesIntegerNumber of opponent fumbles out of bounds
own_recfumblesIntegerNumber of own fumble recoveries
own_rec_tdsfumblesIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumblesIntegerNumber of own fumble recovery yards
Game Statistics - Interception Returns (Team):
AttributeParent ElementTypeDescription
avg_yardsint_returnsDecimalAverage number of yards on interception returns
ex. 38.5
longestint_returnsIntegerNumber of yards of longest interception return
longest_touchdownint_returnsIntegerNumber of yards of longest interception return for a touchdown
returnsint_returnsIntegerNumber of interception returns
touchdownsint_returnsIntegerNumber of interception return touchdowns
yardsint_returnsIntegerNumber of total interception return yards
interceptionsinterceptionsIntegerNumber of interceptions
return_yardsinterceptionsIntegerNumber of interception return yards
returnedinterceptionsIntegerNumber of interceptions returned
Game Statistics - Kick Returns (Team):
AttributeParent ElementTypeDescription
avg_yardskick_returnsDecimalAverage number of yards on kick returns
ex. 19.5
faircatcheskick_returnsIntegerNumber of fair catches on kick returns
longestkick_returnsIntegerNumber of yards of longest kick return
longest_touchdownkick_returnsIntegerNumber of yards of longest kick return for a touchdown
returnskick_returnsIntegerNumber of kick returns
touchdownskick_returnsIntegerNumber of kick return touchdowns
yardskick_returnsIntegerNumber of total kick return yards
Game Statistics - Kickoffs (Team):
AttributeParent ElementTypeDescription
endzonekickoffsIntegerNumber of kickoffs into the endzone
inside_20kickoffsIntegerNumber of kickoffs inside the 20 yardline
kickoffskickoffsIntegerNumber of kickoffs
out_of_boundskickoffsIntegerNumber of kickoffs out of bounds
return_yardskickoffsIntegerNumber of total return yards on kickoffs
total_endzonekickoffsIntegerNumber of total kickoffs into the endzone (touchbacks + endzone kicks)
touchbackskickoffsIntegerNumber of touchbacks
yardskickoffsIntegerNumber of kickoff yards
Game Statistics - Miscellaneous Returns (Team):
AttributeParent ElementTypeDescription
blk_fg_touchdownsmisc_returnsIntegerNumber of blocked field goals returned for touchdowns
blk_punt_touchdownsmisc_returnsIntegerNumber of blocked punts returned for touchdowns
ez_rec_touchdownsmisc_returnsIntegerNumber of end zone recovery touchdowns
fg_touchdownsmisc_returnsIntegerNumber of field goal attempts returned for touchdowns
returnsmisc_returnsIntegerNumber of miscellaneous returns
touchdownsmisc_returnsIntegerNumber of miscellaneous returns for touchdowns
yardsmisc_returnsIntegerNumber of miscellaneous return yardage
Game Statistics - Passing (Team):
AttributeParent ElementTypeDescription
air_yardspassingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
attemptspassingIntegerNumber of pass attempts
avg_pocket_timepassingDoubleAverage time spent in the pocket
ex. 2.477
avg_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
batted_passespassingIntegerNumber of batted pass attempts
blitzespassingIntegerNumber of blitzes
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
defended_passespassingIntegerNumber of pass attempts defended
dropped_passespassingIntegerNumber of pass attempts dropped
first_downspassingIntegerNumber of first downs
hurriespassingIntegerNumber of pass hurries
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
knockdownspassingIntegerNumber of knockdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
net_yardspassingIntegerNumber of net yards passing
on_target_throwspassingIntegerNumber of on target throws
pocket_timepassingDoubleTime spent in the pocket
ex. 101.573
poor_throwspassingIntegerNumber of poor throws
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
spikespassingIntegerNumber of spikes
throw_awayspassingIntegerNumber of throw aways
touchdownspassingIntegerNumber of passing touchdowns
yardspassingIntegerNumber of passing yards
Game Statistics - Penalties (Team):
AttributeParent ElementTypeDescription
first_downspenaltiesIntegerNumber of penalties resulting in a first down
penaltiespenaltiesIntegerNumber of penalties
yardspenaltiesIntegerNumber of penalty yardage
Game Statistics - Punt Returns (Team):
AttributeParent ElementTypeDescription
avg_yardspunt_returnsDecimalAverage number of yards on punt returns
ex. 19.5
faircatchespunt_returnsIntegerNumber of fair catches on punt returns
longestpunt_returnsIntegerNumber of yards of longest punt return
longest_touchdownpunt_returnsIntegerNumber of yards of longest punt return for a touchdown
returnspunt_returnsIntegerNumber of punt returns
touchdownspunt_returnsIntegerNumber of punt return touchdowns
yardspunt_returnsIntegerNumber of total punt return yards
Game Statistics - Punts (Team):
AttributeParent ElementTypeDescription
attemptspuntsIntegerNumber of punt attempts
avg_hang_timepuntsDecimalAverage hang time on punts
ex. 4.163
avg_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
hang_timepuntsDecimalTotal hang time on punts
ex. 16.65
inside_20puntsIntegerNumber of punts inside the 20 yardline
longestpuntsIntegerNumber of yards of longest punt
net_yardspuntsIntegerNumber of total net punt yards
return_yardspuntsIntegerNumber of total return punt yards
out_of_boundspuntsIntegerNumber of punts out of bounds
return_yardspuntsIntegerNumber of total return yards on punts
touchbackspuntsIntegerNumber of touchbacks
yardspuntsIntegerNumber of punt yards
Game Statistics - Receiving (Team):
AttributeParent ElementTypeDescription
air_yardsreceivingIntegerNumber 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_yardsreceivingDecimalAverage yards per reception
ex. 7.22
broken_tacklesreceivingIntegerNumber of receiving broken tackles
catchable_passesreceivingIntegerNumber of catchable passes
dropped_passesreceivingIntegerNumber of dropped passes
first_downsreceivingIntegerNumber of receiving first downs
longestreceivingIntegerNumber of yards of longest reception
longest_touchdownreceivingIntegerNumber of yards of longest receiving touchdown
receptionsreceivingIntegerNumber of receptions
redzone_targetsreceivingIntegerNumber of receiving red zone targets
targetsreceivingIntegerNumber of receiving targets
touchdownsreceivingIntegerNumber of receiving touchdowns
yardsreceivingIntegerNumber of receiving yards
yards_after_catchreceivingIntegerNumber of receiving yards after the catch
yards_after_contactreceivingIntegerNumber of receiving yards after contact
Game Statistics - Rushing (Team):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
broken_tacklesrushingIntegerNumber of rushing broken tackles
first_downsrushingIntegerNumber of rushing first downs
kneel_downsrushingIntegerNumber of rushing kneel downs
longestrushingIntegerNumber of yards of longest rush
longest_touchdownrushingIntegerNumber of yards of longest rushing touchdown
redzone_attemptsrushingIntegerNumber of rushing red zone attempts
scramblesrushingIntegerNumber of rushing scrambles
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
yards_after_contactrushingIntegerNumber of rushing yards after contact
Game Statistics - Touchdowns (Team):
AttributeParent ElementTypeDescription
fumble_returntouchdownsIntegerNumber of fumble return touchdowns
int_returntouchdownsIntegerNumber of interception return touchdowns
kick_returntouchdownsIntegerNumber of kick return touchdowns
othertouchdownsIntegerNumber of touchdowns outside of other categories. Common examples are blocked kicks or punts returned for scores.
passtouchdownsIntegerNumber of passing touchdowns
punt_returntouchdownsIntegerNumber of punt return touchdowns
rushtouchdownsIntegerNumber of rushing touchdowns
totaltouchdownsIntegerNumber of total touchdowns
total_returntouchdownsIntegerNumber of total return touchdowns
Game Statistics - Team Summary:
AttributeParent ElementTypeDescription
avg_gainsummaryDecimalAverage yards per play
ex. 7.6
fumblessummaryIntegerNumber of fumbles
lost_fumblessummaryIntegerNumber of fumbles lost
penaltiessummaryIntegerNumber of penalties
penalty_yardssummaryIntegerNumber of penalty yards
play_countsummaryIntegerNumber of offensive plays
possession_timesummaryIntegerTime of possession
ex. 36:38
return_yardssummaryIntegerNumber of return yards
rush_playssummaryIntegerNumber of rushing plays
safetiessummaryIntegerNumber of safeties
total_yardssummaryIntegerNumber of total yards
turnoverssummaryIntegerNumber of turnovers
League:
AttributeParent ElementTypeDescription
idsummary - seasonGUIDUnique season ID
ex. 75749c10-56c1-4ae0-9d1e-2689708debdf
namesummary - seasonStringName of the season
PRE,REG,PST
typesummary - seasonStringType of the season
PRE,REG,PST
yearsummary - seasonIntegerYear of the season
idsummary - weekGUIDUnique week ID
ex. 57b447ce-bc66-47f7-9760-89d328d3db9f
sequencesummary - weekIntegerWeek sequence number
titlesummary - weekStringWeek title
Metadata:
AttributeParent ElementTypeDescription
leaguemetadataStringAlias of a league
ex. nfl
localemetadataStringLanguage code
ex. en (English)
matchmetadataGUIDUnique ID(s) of a game
ex. sd:match:1a57777c-7c57-43fa-bf08-66bffc204fd1,sr:match:33623353
operationmetadataStringOperation of an update
update, delete
participantmetadataGUIDUnique ID(s) of a team or player
ex. sd:team:1f6dcffb-9823-43cd-9ff4-e7a8466749b5,sr:competitor:4429
statusmetadataStringThe status of a game
scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
See our NFL FAQ for game status descriptions
versionmetadataStringVersion of the API
ex. v7
Player:
AttributeParent ElementTypeDescription
nameplayerStringFull name of a player
ex. George Kittle
idplayerGUIDUnique ID of a player
ex. 7e648a0b-fdc8-4661-a587-5826f2cac11b
jerseyplayerStringJersey number of a player
positionplayerStringPosition of an NFL player
sr_idplayerStringUnique Sportradar player ID
ex. sr:player:828235
Standings:
AttributeParent ElementTypeDescription
losseshome / away - recordIntegerNumber of team losses year-to-date before the game. Record is updated post-game based on the game outcome
tieshome / away - recordIntegerNumber of team ties year-to-date before the game. Record is updated post-game based on the game outcome
winshome / away - recordIntegerNumber of team wins year-to-date before the game. Record is updated post-game based on the game outcome
Team:
AttributeParent ElementTypeDescription
aliasteamStringTeam alias
ex. MIN (Minnesota)
idteamGUIDUnique ID of a team
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketteamStringTeam market name
ex. Minnesota
nameteamStringTeam name
ex. Vikings
sr_idteamStringUnique Sportradar ID of a team
ex. sr:competitor:4324
Venue:
AttributeParent ElementTypeDescription
addresssummary - venueStringAddress of a venue
ex. 900 S 5th Street
capacitysummary - venueIntegerCapacity of a venue
ex. 72220
citysummary - venueStringCity of a venue
ex. Minneapolis
countrysummary - venueStringCountry of a venue
ex. USA
idsummary - venueGUIDUnique ID of a venue
ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346
latsummary - venue - locationDecimalLatitude of a venue
ex. 29.684735
lngsummary - venue - locationDecimalLongitude of a venue
ex. -95.410725
namesummary - venueStringName of a venue
ex. U.S. Bank Stadium
roof_typesummary - venueStringRoof type of a venue
outdoor,dome,retractable_dome
sr_idsummary - venueStringUnique Sportradar venue ID
ex. sr:venue:2402
statesummary - venueStringState of a venue
ex. MN
surfacesummary - venueStringSurface type of a venue
turf,artificial
zipsummary - venueIntegerZIP code of a venue
ex. 77054