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. Please note that the Push Statistics feed has been enhanced to include addition game data. See here for an updated Statistics sample.