Push Events

Syntax

https://api.sportradar.com/nfl/official/{access_level}/stream/{language_code}/events/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
`event_category`	Event category expressed as: {event_category}. Example: event_category=redzone Valid event categories: redzone, two_minute, scoring_play, big_play, turnover
`event_type`	Event type expressed as: {event_type}. Example: event_type=timeout Valid event types: setup, timeout, tv_timeout, two_minute_warning, comment, period_end, game_over
`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:673b459c-7506-4c11-9273-1b9502537f1d
`status`	Status type expressed as: inprogress or created. Example: status=inprogress
`team`	Team id expressed as: sd:team:{team_id}. Example: team_id=sd:team:4415b0a7-0f24-11e2-8525-18a905767e44

Code Samples

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

url = URI("https://api.sportradar.us/nfl/official/trial/stream/en/events/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/events/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/events/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/events/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/events/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/events/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.

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.