Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Statistics

USFL Push Statistics provides detailed, real-time game stats at the team and player level for all live games.

Syntax

https://api.sportradar.com/usfl/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).
your_api_keyYour API key.

Optional Query String Parameters

In addition to the URL parameters listed above, you can filter the Statistics 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
event_categoryEvent category expressed as: {event_category}.
Example: event_category=redzone
Valid event categories: redzone, two_minute, scoring_play, big_play, turnover
event_typeEvent type expressed as: {event_type}.
Example: event_type=timeout
Valid event types: setup, timeout, tv_timeout, two_minute_warning, comment, period_end, game_over
localeLocale expressed as 2 letter code: locale={language_code}
Example: locale:en
matchMatch id expressed as: sd:match:{match_id}.
Example: sd:match:673b459c-7506-4c11-9273-1b9502537f1d
statusStatus type expressed as: inprogress or created.
Example: status=inprogress
teamTeam id expressed as: sd:team:{team_id}.
Example: sd:team:4415b0a7-0f24-11e2-8525-18a905767e44


Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.us/usfl/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/usfl/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/usfl/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/usfl/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/usfl/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/usfl/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'


Response Sample

The above commands return json like this.



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. NO (New Orleans)
idawayGUIDUnique ID of the away team
ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12
marketawayStringAway team market name
ex. New Orleans
nameawayStringAway team name
ex. Breakers
sr_idawayStringUnique Sportradar ID of the away team
ex. sr:competitor:882413
conference_gamepayloadBooleanSignifies an in-Conference matchup
durationpayloadStringDuration of the game
ex. 2:52
entry_modepayloadStringType of data entry for the game
LDE (Live Data Entry)
aliashomeStringHome team alias
ex. PIT
idhomeGUIDUnique ID of the home team
ex. c8797380-9677-11ec-9193-6b32ce92fd29
markethomeStringHome team market name
ex. Pittsburgh
namehomeStringHome team name
ex. Maulers
sr_idhomeStringUnique Sportradar ID of the home team
ex. sr:competitor:882423
idpayloadGUIDUnique ID of a game
ex. 03aa477c-de6a-4d7a-90f4-97eed05f2e89
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, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbd

See our USFL FAQ for game status descriptions
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
combineddefenseIntegerNumber of combined tackles
forced_fumblesdefenseIntegerNumber of forced fumbles
fumble_recoveriesdefenseIntegerNumber of fumble recoveries
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
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
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_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
first_downspassingIntegerNumber of first downs
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
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_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
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
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
Game Statistics - Rushing (Player):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
first_downsrushingIntegerNumber of rushing first 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
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
Game Statistics - Special Conversions (Player):
AttributeParent ElementTypeDescription
attemptsspecial_conversionsIntegerNumber of three-point conversion attempts
successesspecial_conversionsIntegerNumber of successful three-point conversions
categoryspecial_conversionsStringType of three-point conversion attempt
pass, receive, rush, defense
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
combineddefenseIntegerNumber of combined tackles
forced_fumblesdefenseIntegerNumber of forced fumbles
fourth_down_stopsdefenseIntegerNumber of fourth down stops
fumble_recoveriesdefenseIntegerNumber of fumble recoveries
interceptionsdefenseIntegerNumber of interceptions
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 - onside_scrimmageIntegerNumber of onside scrimmage attempts
successesefficiency - onside_scrimmageIntegerNumber of onside scrimmage successes
pctefficiency - onside_scrimmageDecimalOnside scrimmage conversion percentage
ex. 50.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_goalsIntegerNumber 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_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
first_downspassingIntegerNumber of first downs
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
net_yardspassingIntegerNumber of net yards passing
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
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_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
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
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
Game Statistics - Rushing (Team):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
first_downsrushingIntegerNumber of rushing first downs
longestrushingIntegerNumber of yards of longest rush
longest_touchdownrushingIntegerNumber of yards of longest rushing touchdown
redzone_attemptsrushingIntegerNumber of rushing red zone attempts
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
Game Statistics - Special Conversions (Team):
AttributeParent ElementTypeDescription
defense_three_point_attemptsspecial_conversionsIntegerNumber of three-point defensive conversion attempts
defense_three_point_successesspecial_conversionsIntegerNumber of successful three-point defensive conversions
pass_three_point_attemptsspecial_conversionsIntegerNumber of three-point passing conversion attempts
pass_three_point_successesspecial_conversionsIntegerNumber of successful three-point passing conversions
rush_three_point_attemptsspecial_conversionsIntegerNumber of three-point rushing conversion attempts
rush_three_point_successesspecial_conversionsIntegerNumber of successful three-point rushing conversions
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. 234f28d6-b9d7-4881-a890-30b451c13aec
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. eb5f5b92-6a4e-42a7-b590-3f0ce7cc4736
sequencesummary - weekIntegerWeek sequence number
titlesummary - weekStringWeek title
Metadata:
AttributeParent ElementTypeDescription
leaguemetadataStringAlias of a league
ex. usfl
localemetadataStringLanguage code
ex. en (English)
matchmetadataGUIDUnique ID(s) of a game
ex. sd:match:932eea38-0d94-4db5-b861-69b1a0ca47dc,sr:match:32567857
operationmetadataStringOperation of an update
update, delete
participantmetadataGUIDUnique ID(s) of a team or player
ex. sd:team:c8797380-9677-11ec-9193-6b32ce92fd29,sr:competitor:882423
statusgameStringGame status
scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbd

See our USFL FAQ for game status descriptions
versionmetadataStringVersion of the API
ex. v6
Player:
AttributeParent ElementTypeDescription
nameplayerStringFull name of a player
ex. Deon Cain
idplayerGUIDUnique ID of a player
ex. f99a57a0-bdb7-11ed-a9cf-659b88c64826
jerseyplayerIntegerJersey number of a player
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
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. PIT
idteamGUIDUnique ID of a team
ex. c8797380-9677-11ec-9193-6b32ce92fd29
marketteamStringTeam market name
ex. Pittsburgh
nameteamStringTeam name
ex. Maulers
sr_idteamStringUnique Sportradar ID of a team
ex. sr:competitor:882423
Venue:
AttributeParent ElementTypeDescription
addresssummary - venueStringAddress of a venue
ex. 1020 24th St N
capacitysummary - venueIntegerCapacity of a venue
ex. 47100
citysummary - venueStringCity of a venue
ex. Birmingham
countrysummary - venueStringCountry of a venue
ex. USA
idsummary - venueGUIDUnique ID of a venue
ex. b1f3fd20-90f4-11ec-bf38-efe8ff3d0b79
namesummary - venueStringName of a venue
ex. Protective Stadium
roof_typesummary - venueStringRoof type of a venue
outdoor, dome, retractable_dome
sr_idsummary - venueStringUnique Sportradar venue ID
ex. sr:venue:58724
statesummary - venueStringState of a venue
ex. AL
surfacesummary - venueStringSurface type of a venue
turf, artificial
zipsummary - venueIntegerZIP code of a venue
ex. 35203