Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Events

WNBA Push Events retrieves detailed, real-time information on every game event.

Syntax

https://api.sportradar.us/wnba/{access_level}/stream/events/subscribe?api_key={your_api_key}

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
your_api_keyYour API key

Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

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.

ParameterDescription
event_categoryEvent category

Example: event_category=shot
event_typeEvent type

Example: event_type=stoppage
localeLanguage returned expressed as a 2-letter code

en (English)

Example: locale=en
matchMatch id

Example: match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b
operationOperation type

update, delete, insert

Example: operation=update
playersPlayer id

Example: players=sd:player:e49da6d1-dd65-44f9-9a5f-d60010d8c384
statusGame status

inprogress, created

Example: status=inprogress
teamTeam id

Example: team=sd:team:6f017f37-be96-4bdc-b6d3-0a0429c72e89


Code Samples

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

url = URI("https://api.sportradar.us/wnba/trial/stream/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/wnba/trial/stream/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/wnba/trial/stream/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/wnba/trial/stream/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b")

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/wnba/trial/stream/events/subscribe",
    params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:b9cf745b-36a1-404e-8159-78d719742a6b'},
    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/wnba/trial/stream/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b'


Response Sample

The above commands return json like this.



Data Points

Game:
AttributeParent ElementTypeDescription
coveragegameStringCoverage level of a game
full, extended_boxscore
idgameGUIDUnique ID of a game
ex. 1b38e436c-985b-4f59-8a25-68b73b4a98a1
referencegameStringLeague reference ID of a game
ex. 1021900149
sr_idgameGUIDUnique Sportradar ID of a game
ex. sr:match:17582493
statusgameStringThe status of a game
scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessary

Please see our FAQ section for a list of game status definitions
titlegameStringTitle of a game
ex. Game 3
scheduledgamedateTimeScheduled date and time of a game
ex. 2024-02-14T05:00:00Z
Metadata:
AttributeParent ElementTypeDescription
event_categorymetadataStringCategory of an event
ex. lineupchange or shot
event_typemetadataStringType of an event
ex. threepointmiss or rebound
leaguemetadataStringAlias of a league
ex. WNBA
localemetadataStringLanguage code
ex. en (English)
matchmetadataGUIDUnique ID of a game
ex. sd:match:b38e436c-985b-4f59-8a25-68b73b4a98a1,sr:match:17582493
operationmetadataStringOperation of an update
update, delete
playersmetadataGUIDUnique ID(s) of players associated with an event
ex. sd:player:6f20a6c1-04f6-4be2-b7a2-511ebe314525,sd:player:7b8d55dd-2f12-46fb-9051-ade709b96dd5
statusmetadataStringThe status of a game
scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessary

Please see our FAQ section for a list of game status definitions
teammetadataGUIDUnique ID(s) of team(s) associated with an event
ex. sd:team:0699edf3-5993-4182-b9b4-ec935cbd4fcc,sr:team:3444
versionmetadataStringVersion of the API
ex. v7
Play-by-Play - Attribution & Possession:

Attribution is the team associated with the play-by-play event (i.e. the statistic associated with it). Possession is the team who currently has the possession of the ball as a result of that play-by-play event.

AttributeParent ElementTypeDescription
idevent - attributionGUIDUnique ID of a team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketevent - attributionStringMarket name of a team
ex. Phoenix
nameevent - attributionStringTeam name
ex. Mercury
referenceevent - attributionStringLeague reference ID of a team
ex. 1611661317
sr_idevent - attributionGUIDUnique Sportradar ID of a team
ex. sr:team:3444
team_basketevent - attributionStringThe basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.
left, right
idevent - possessionGUIDUnique ID of a team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketevent - possessionStringMarket name of a team
ex. Phoenix
nameevent - possessionStringTeam name
ex. Mercury
sr_idevent - possessionGUIDUnique Sportradar ID of a team
ex. sr:team:3444
Play-by-Play - Home/Away Teams:
AttributeParent ElementTypeDescription
bonusgame - awayBooleanSignifies a team is in the bonus
pointsgame - awayIntegerTotal points for the away team
idgame - awayGUIDUnique ID of the away team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketgame - awayStringMarket name of the away team
ex. Phoenix
namegame - awayStringAway team name
ex. Mercury
referencegame - awayStringLeague reference ID of the away team
ex. 1611661317
remaining_timeoutsgame - awayIntegerRemaining timeouts for the away team
sr_idgame - awayGUIDUnique Sportradar ID of the away team
ex. sr:team:3444
bonusgame - homeBooleanSignifies a team is in the bonus
pointsgame - homeIntegerTotal points for the home team
idgame - homeGUIDUnique ID of the home team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketgame - homeStringMarket name of the home team
ex. Phoenix
namegame - homeStringHome team name
ex. Mercury
referencegame - homeStringLeague reference ID of the home team
ex. 1611661317
remaining_timeoutsgame - homeIntegerRemaining timeouts for the home team
sr_idgame - homeGUIDUnique Sportradar ID of the home team
ex. sr:team:3444
Play-by-Play - Event:
AttributeParent ElementTypeDescription
clock_decimaleventStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock
ex. 00:21.70
createdeventdateTimeTimestamp of the creation of an event
ex. 2024-02-14T05:00:00Z
attempteventStringText description of a free throw attempt
ex. 1 of 2 or 2 of 2
away_pointseventIntegerTotal points for the away team after an event
clockeventStringClock value of an event
ex. 12:37
descriptioneventStringText description of an event
ex. Kevon Looney makes two point jump shot (Klay Thompson assists)
event_typeeventStringType of event
ex. turnover or rebound

See our FAQ for a complete list of types
home_pointseventIntegerTotal points for the home team after an event
ideventGUIDUnique ID of an event
ex. b9feda23-c03f-4304-afa4-06d7dc830651
action_areaevent - locationStringAction area of an event
underbasket, inthepaint, insiderightwing, insideright, insidecenter, insideleft, insideleftwing, outsideright, outsidecenter, outsideleft, outsideleftwing, backcourt

Please see our FAQ for detailed plot points of our action areas
coord_xevent - locationIntegerX coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
coord_yevent - locationIntegerY coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
numbereventIntegerSequential number of an event in a game
qualifierevents - qualifiers - qualifierStringAdditional descriptor of a play-by-play event type.
Appears only in JSON format
2ndchance, fastbreak, fromturnover, defensivegoaltending, pointsinthepaint, fastbreak, fromturnover, team, deadball, 1freethrow.2freethrow, mandatory
rescindedeventBooleanSignifies a technical foul event_type="technicalfoul") has been rescinded by the league when true
sequenceeventIntegerUNIX timestamp of the wall clock value. Use this value to help sequence play-by-play events (smallest to largest sequence number}.
ex. 1678835426293
turnover_typeeventStringType of turnover
ex. Traveling or Lane Violation

See our FAQ for a complete list of types
createdeventdateTimeTimestamp of the creation of an event
ex. 2024-02-14T05:00:00Z
updatedeventdateTimeTimestamp of the last update to an event
ex. 2024-02-14T05:00:00Z
wall_clockeventdateTimeTimestamp in UTC when the on-venue statistician began entry of a play-by-play event.
ex. 2023-03-14T23:10:26Z
Play-by-Play - Play Participants & Stats:
AttributeParent ElementTypeDescription
idevent - statistics - teamGUIDUnique ID of a team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketevent - statistics - teamStringMarket name of a team
ex. Phoenix
nameevent - statistics - teamStringTeam name
ex. Mercury
referenceevent - statistics - teamStringLeague reference ID of a team
ex. 1611661317
sr_idevent - statistics - teamGUIDUnique Sportradar ID of a team
ex. sr:team:3444
full_nameevent - statistics - playerStringFull name of a player
ex. Leilani Mitchell
idevent - statistics - playerGUIDUnique player ID
ex. 7b8d55dd-2f12-46fb-9051-ade709b96dd5
jersey_numberevent - statistics - playerIntegerNumber of a player's jersey
referenceevent - statistics - playerStringLeague reference ID of a player
ex. 1626157
sr_idevent - statistics - playerGUIDUnique Sportradar ID of a player
ex. sr:player:608110
madeevent - statisticsBooleanSignifies a made basket
pointsevent - statisticsIntegerNumber of points scored for an event
rebound_typeevent - statistics - reboundStringRebound type
defensive, offensive
shot_distanceevent - statisticsDecimalShot distance in feet from the basket
ex. 2.37
shot_typeevent - statisticsStringShot type
jump shot, layup, dunk, hook, tip
shot_type_descevent - statisticsStringText description of a shot type
ex. driving or alley-oop

See our FAQ for a complete list of descriptions
three_point_shotevent - statisticsBooleanSignifies a 3-point attempt
madeevent - statistics - freethrowBooleanSignifies a made free throw
free_throw_typeevent - statistics - freethrowStringType of free throw
ex. regular, technical, flagrant, clear path
Play-by-Play - On Court Participants:
AttributeParent ElementTypeDescription
full_nameevent - on_court - home / away - playersStringFull name of a player
ex. Leilani Mitchell
idevent - on_court - home / away - playersGUIDUnique player ID
ex. 7b8d55dd-2f12-46fb-9051-ade709b96dd5
jersey_numberevent - on_court - home / away - playersIntegerNumber of a player's jersey
referenceevent - on_court - home / away - playersStringLeague reference ID of a player
ex. 1626157
sr_idevent - on_court - home / away - playersGUIDUnique Sportradar ID of a player
ex. sr:player:608110
idevent - on_court - home / awayGUIDUnique ID of a team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketevent - on_court - home / awayStringMarket name of a team
ex. Phoenix
nameevent - on_court - home / awayStringTeam name
ex. Mercury
referenceevent - on_court - home / awayStringLeague reference ID of a team
ex. 1611661317
sr_idevent - on_court - home / awayGUIDUnique Sportradar ID of a team
ex. sr:team:3444
Quarter:
AttributeParent ElementTypeDescription
idperiodGUIDUnique ID of a quarter
ex. fece1ac0-b703-4478-8a7c-3f27313dec97
numberperiodIntegerNumber of a quarter
sequenceperiodIntegerSequential number of a quarter
typeperiodGUIDType of period
ex. quarter