NBA Push Events retrieves detailed, real-time information on every game event.
Syntax
| https://api.sportradar.com/draft/nba/{access_level}/stream/{language_code}/events/subscribe?api_key={your_api_key} |
Replace the placeholders with the following path parameters.
| Parameter | Description |
|---|---|
access_level | Defines the access level of your API key as Production (production), Trial (trial), or Simulation (simulation). |
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 Clock information with one or more of the following optional query string parameters.
Note
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=shot |
event_type | Event type expressed as: {event_type}. Example: event_type=stoppage |
locale | Locale expressed as 2 letter code: locale={language_code} Example: locale:en |
match | Match id expressed as: sd:match:{match_id}. Example: sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56 |
players | Player id expressed as: sd:player:{player_id}. Example: sd:player:c1ff3e58-266f-4183-9fa1-d7c914cf4886 |
status | Status type expressed as: inprogress or created. Example: status=inprogress |
team | Team id expressed as: sd:team:{team_id}. Example: sd:team:583eca2f-fb46-11e1-82cb-f4ce4684ea4c |
Code Samples
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/nba/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/nba/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/nba/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.com/nba/trial/stream/en/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56")
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/nba/trial/stream/en/events/subscribe",
params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'},
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/nba/trial/stream/en/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'