WNBA v4
Frequently Asked Questions
## WNBA API Map
To best utilize the WNBA API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
>
## Coverage Levels
We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.
Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the game within 30 minutes of the official results being posted. Extended Boxscore coverage is available for any pre-season game not available via a reliable broadcast.
Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team and player level data in near real time. Full coverage is available for all regular and post-season games as well as those pre-season games available live via a broadcast.
## Daily Change Log
Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/league/2017/07/09/changes.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/league/2017/07/09/changes.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/league/2017/07/09/changes.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Change Log feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Change Log, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/changelog-v2.0.xsd
Return to API map
## Daily Schedule
Date, time, location, and other event details for every game taking place in the league-defined day.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/games/2017/08/08/schedule.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/games/2017/08/08/schedule.xml?api_key{your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/games/2017/08/08/schedule.xml?api_key{your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/schedule-v3.0.xsd
Return to API map
## Daily Transfers
Information for all transfers added or edited during the league-defined day.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/league/2018/02/01/transfers.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/league/2018/02/01/transfers.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/league/2018/02/01/transfers.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Transfers feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/transfers.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Transfers, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/transfers-v2.0.xsd
Return to API map
## Free Agents
Detailed player information for all current free agents in the league.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/league/free_agents.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/league/free_agents.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/league/free_agents.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Free Agents feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/league/free_agents.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Free Agents, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/free-agents-v2.0.xsd
Return to API map
## Game Boxscore
Top-level team scores by quarter, along with full statistics for each teams’ leaders in points, rebounds, and assists.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/boxscore.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/boxscore.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/boxscore.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Boxscore feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/boxscore.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Game Boxscore, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/game-v3.0.xsd
Return to API map
## Game Summary
Top-level boxscore information along with detailed game stats at the team and player levels.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/summary.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/summary.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Summary feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/summary.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Game Summary, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/game-v3.0.xsd
Return to API map
## Injuries
Information concerning all active player injuries for each WNBA team.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/league/injuries.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/league/injuries.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/league/injuries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Injuries feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/league/injuries.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Injuries, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/injuries-v2.0.xsd
Return to API map
## League Hierarchy
League, conference, division, and team identification and association information.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/league/hierarchy.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/league/hierarchy.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/league/hierarchy.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the League Hierarchy feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/league/hierarchy.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for League Hierarchy, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/wnba/hierarchy-v2.0.xsd
Return to API map
## League Leaders
WNBA leader information for various offensive and defensive categories including full player seasonal statistics for each player in each category.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/leaders.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/seasons/2017/REG/leaders.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the League Leaders feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{wnba_season}`/leaders.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), Postseason (PST), or Commissioner's Cup (CC). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for League Leaders, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/statistics-v3.0.xsd
Return to API map
## Play-By-Play
Detailed, real-time information on every team possession and game event.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/pbp.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/pbp.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/games/0144c46e-e830-4082-8558-933a21923e60/pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Play-By-Play feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Play-By-Play, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/pbp-v3.0.xsd
Return to API map
## Player Profile
Provides player biographical information, draft information, and seasonal statistics for the regular season.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/players/3f53a238-b4df-4861-b260-73fc309d6e94/profile.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/players/3f53a238-b4df-4861-b260-73fc309d6e94/profile.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/players/3f53a238-b4df-4861-b260-73fc309d6e94/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Player Profile feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `player_id` | ID for a given player. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Player Profile, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/profile-v3.0.xsd
Return to API map
## Rankings
Conference and division rank for each team, including playoff clinching status.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/rankings.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/seasons/2017/REG/rankings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Rankings feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{wnba_season}`/rankings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Rankings, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/wnba/rankings-v3.0.xsd
Return to API map
## Schedule
Date, time, location, and other event details for every match-up taking place in the full league season.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/games/2017/REG/schedule.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/games/2017/REG/schedule.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/games/2017/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/games/`{season_year}`/`{wnba_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), Postseason (PST), or Commissioner's Cup (CC). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/schedule-v3.0.xsd
Return to API map
## Seasonal Statistics (Season To Date)
Provides complete team and player seasonal statistics for a given season and season type.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/seasons/2017/REG/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Seasonal Statistics feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{wnba_season}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), Postseason (PST), or Commissioner's Cup (CC). |
| `team_id` | ID for a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Seasonal Statistics, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/statistics-v3.0.xsd
Return to API map
## Series Schedule
Playoff participant information as well as the date, time, location, and other event details for every match-up taking place for the entire playoffs.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/series/2017/PST/schedule.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/series/2017/PST/schedule.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/series/2017/PST/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Series Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/series/`{season_year}`/`{wnba_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Series Schedule, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/schedule-v3.0.xsd
Return to API map
## Series Statistics (Series To Date)
Detailed team and player statistics for a given playoff series.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/series/327eacad-cb4c-4ec9-b67b-dc149c869a31/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/series/327eacad-cb4c-4ec9-b67b-dc149c869a31/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/series/327eacad-cb4c-4ec9-b67b-dc149c869a31/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Series Statistics feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/series/`{series_id}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `series_id` | ID of a given series. |
| `wnba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `team_id` | ID for a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Series Statistics, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/statistics-v3.0.xsd
Return to API map
## Standings
Detailed team records across various views including, overall, conference, and division information.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/standings.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/seasons/2017/REG/standings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/seasons/2017/REG/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Standings feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{wnba_season}`/standings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `wnba_season` | Preseason (PRE), Regular Season (REG), Postseason (PST), or Commissioner's Cup (CC). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/wnba/standings-v3.0.xsd
Return to API map
## Team Profile (Rosters)
Provides top-level team information and a full roster of active players.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/v4/en/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/profile.xml?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
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/wnba/trial/v4/en/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/profile.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/wnba/trial/v4/en/teams/6f017f37-be96-4bdc-b6d3-0a0429c72e89/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Team Profile feed by replacing the parameters in the following URL:
https://api.sportradar.us/wnba/`{access_level}`/`{version}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v4). |
| `language_code` | 2 letter code for supported language: en (English). |
| `team_id` | ID for a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Team Profile, replace the parameters in the following URL.
https://feed.elasticstats.com/schema/basketball/team-v2.0.xsd
Return to API map
## Push Feeds
>To best utilize Push feeds, we have included code samples in Ruby, Java and Python which provide an example of a way you can consume the feeds. Using these samples will output the feeds content to STDOUT.
For Java, we have also provided a Stream Client to assist your integration.
Note: In the provided Java sample, replace "URL GOES HERE" with the desired Push feed URL. ```ruby require 'httpclient' module Sportradar module HTTP module Stream class Client attr_reader :url, :logger def initialize(url, publisher, logger) @url = url @logger = logger @publisher = publisher @client = ::HTTPClient.new(:agent_name => 'SportsData/1.0') end def start @thread ||= Thread.new do logger.debug "Starting loop" @client.get_content(url, :follow_redirect => true) do |chunk| @publisher.publish(::JSON.parse(chunk)) if @publisher end logger.debug "finished loop" end end def stop @thread.terminate if @thread end end end end end ``` ```java package com.sportradar.http.stream.client; import org.junit.After; import org.junit.Before; import org.junit.Test; public class StreamClientTest { private StreamClient client; private static String SERVICE_URL = "";
@Before
public void setup() {
client = new StreamClient();
}
@After
public void cleanup() {
client.terminate();
}
@Test
public void testStream() throws Exception {
Handler handler = new ConsoleHandler();
client.stream(SERVICE_URL, handler);
System.out.println("Connecting....");
Thread.sleep(1 * 60 * 1000);
System.out.println("Disconnecting....");
}
}
```
Some of our APIs include Push feeds that allow you to get updates as soon as they are available. Push API feeds automatically send JSON payload to you via a push service, and can dramatically reduce the number of calls you need to make to our RESTful API feeds. The structure of the Push feeds are similar to the structure of the corresponding RESTful API feed (i.e. Push Clock, Push Events, and Push Statistics). The push service ensures reliable and efficient delivery of the most up to date information.
Our Push services are based on a HTTP publish/subscribe model. When making a call to the Push APIs, you "subscribe" to various data feeds provided by our service; whenever new content is available on one of those feeds, the server pushes that information out to your client. When no new information is available on the feed, a heartbeat message is sent every 5 seconds to keep the connection active. If you want to filter the results of the feeds, there are several optional query string parameters that can be applied to the API call. If left unfiltered, than all data for the feed is displayed (i.e. all games, events, or statistics).
For your applications to accept data from our Push feeds, ensure that your application can:
* Can follow a HTTP redirect or use the location provided in the feeds header within one minute of your initial request.
* Can accept HTTP data transfer encoded as chunked.
Our Push service does not provide a "stateful session", there is no memory of what data has been sent previously. If you are disconnected from the Push session, you can use the RESTful API to catch up or recover from the disconnection.
Syntax for using our Push feeds and examples of the JSON payloads can be found below.
## Push Clock
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/stream/clock/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
```
```python
import requests
import json
r = requests.get("https://api.sportradar.com/wnba/trial/stream/clock/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))
```
```shell
curl -L GET 'api.sportradar.us/wnba/trial/stream/clock/subscribe?api_key={your_api_key}'
```
> The above command returns json like this.
This endpoint retrieves a game clock feed with high level scoring and possession information.
https://api.sportradar.us/wnba/`{access_level}`/stream/clock/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). |
| `your_api_key` | Your API key. |
### Optional Query String Parameters
>Example including optional query string parameters:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba/trial/stream/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60")
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
```
```python
import requests
import json
r = requests.get("https://api.sportradar.com/wnba/trial/stream/clock/subscribe",
params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:0144c46e-e830-4082-8558-933a21923e60'},
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))
```
```shell
curl -L GET 'api.sportradar.us/wnba/trial/stream/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60'
```
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.
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: sd:match:0144c46e-e830-4082-8558-933a21923e60 | | `operation` | Update (update), delete (delete), or insert (insert). | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Push Events ```ruby 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 ``` ```python 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/events/subscribe?api_key={your_api_key}' ``` >The above command returns json like this. This endpoint retrieves detailed, real-time information on every game event. https://api.sportradar.us/wnba/`{access_level}`/stream/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). | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby 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:0144c46e-e830-4082-8558-933a21923e60") 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 ``` ```python 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:0144c46e-e830-4082-8558-933a21923e60'}, 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60' ``` 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.
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:0144c46e-e830-4082-8558-933a21923e60 | | `operation` | Update (update), delete (delete), or insert (insert). | | `players` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:e49da6d1-dd65-44f9-9a5f-d60010d8c384 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:6f017f37-be96-4bdc-b6d3-0a0429c72e89 | Return to API map ## Push Statistics ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/wnba/trial/stream/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 ``` ```python import requests import json r = requests.get("https://api.sportradar.com/wnba/trial/stream/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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}' ``` > The above command returns json like this. This endpoint retrieves detailed, real-time game stats at the team and player level for all live games. https://api.sportradar.us/wnba/`{access_level}`/stream/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). | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60") 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 ``` ```python import requests import json r = requests.get("https://api.sportradar.com/wnba/trial/stream/statistics/subscribe", params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:0144c46e-e830-4082-8558-933a21923e60'}, 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60' ``` 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.
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: sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40 | | `operation` | Update (update), delete (delete), or insert (insert). | | `player` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:e49da6d1-dd65-44f9-9a5f-d60010d8c384 | | `stats_type` | Stat type expressed as {stats_type}. Example: stats_type=player | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:6f017f37-be96-4bdc-b6d3-0a0429c72e89 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Frequently Asked Questions
| API | API Version | Failover | XSD Schema |
| WNBA | v4 | Failover Details Failover Summary |
Download |
| Note: Authentication is required for all API calls. |
Examples:
>To find a team's leader in assists for a given game: >- Call the season or series schedule and find the Game Id for the chosen game
- Call the Game Boxscore using the Game Id
- Find the Team Assists Leader statistics and locate the player full_name attribute
- Call the season or series schedule and find id for the team the player is on
- Call the Team Profile using the Team ID
- Locate the Player ID for your chosen player and call the Player Profile.
- Find the average element with the points attribute
## Coverage Levels
We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.
Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the game within 30 minutes of the official results being posted. Extended Boxscore coverage is available for any pre-season game not available via a reliable broadcast.
Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team and player level data in near real time. Full coverage is available for all regular and post-season games as well as those pre-season games available live via a broadcast.
| Note: Preseason coverage of WNBA games may vary. Due to data-entry coverage (from venue) not being available, some games may be covered via our extended boxscore coverage. |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| Game Data Points: | Id Reference |
Title | Updated Timestamp |
| League Data Points: | Alias Id |
Name | Season |
| Player Data Points: | Full Name Id |
Reference | Updated Timestamp |
| Team Data Points: | Id Market |
Name Reference |
Updated Timestamp |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| Game Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Away Team Seed Number Broadcast Cable Broadcast Internet |
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Reference |
Home Team Seed Number Id Neutral Site Reference Scheduled Date and Time Status Title Track on Court |
| League Data Points: | Alias | Id | Name |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias | Id | Name |
| Player Data Points: | First Name Full Name Id Jersey Number Last Name Position Primary Position Reference |
Transfers Description Transfers Effective Date Transfers End Date Transfers Id Transfers New Team Id Transfers New Team Market Transfers New Team Name Transfers New Team Reference |
Transfers Notes Transfers Old Team Id Transfers Old Team Market Transfers Old Team Name Transfers Old Team Reference Transfers Start Date Transfers Update Date |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | League Alias | League Id | League Name |
| Player Data Points: | Abbreviated name Birth Date Birth Place College Experience |
First Name Full Name Height (in) Jersey Number Last Name |
Player Id Position Primary Position Reference Status Weight (lbs) |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Boxscore Data Points: | Attendance Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Quarter Score Away Team Reference Clock Duration |
Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Quarter Score Home Team Reference Lead Changes Quarter Quarter Number |
Quarter Sequence Team Assists Leader Player Full Name Team Assists Leader Player Id Team Points Leader Player Full Name Team Points Leader Player Id Team Rebounds Leader Player Full Name Team Rebounds Leader Player Id Times Tied |
| Game Data Points: | Away Team Id Away Team Reference Coverage Entry Mode Home Team Id |
Home Team Reference Id Neutral Site Reference |
Scheduled Date And Time Status Track on Court Title |
| Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rebounds Double Double Effective Field Goal Percentage Efficiency Efficiency Game Score Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls |
Fouls Drawn Free Throw Attempts Free Throw Percentage Free Throws Made Minutes Played Offensive Fouls Offensive Rebounds Personal Fouls Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage Points off Rebounds Rebounds |
Second Chance Points Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made |
| Player Data Points: | Full Name Id |
Jersey Number Position |
Primary Position Reference |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Boxscore Data Points: | Attendance Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Quarter Score Away Team Reference Clock Duration Game Officials Assignment Game Officials Experience |
Game Officials First Name Game Officials Full Name Game Officials Id Game Officials Last Name Game Officials Number Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Quarter Score |
Home Team Reference Lead Changes Period Id Period Number Period Sequence Period Type Quarter Quarter Number Quarter Sequence Times Tied |
| Game Data Points: | Away Team Id Away Team Reference Coverage Entry Mode Home Team Id |
Home Team Reference Id Neutral Site Reference |
Scheduled Date And Time Status Track on Court Title |
| Player Period Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rating Defensive Rebounds Defensive Rebounds Percentage Effective Field Goal Percentage Efficiency Efficiency Game Score Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goals Attempted Field Goals Made Field Goals Percentage Flagrant Fouls Fouls Drawn |
Free Throw Percentage Free Throws Attempted Free Throws Made Minus Minutes Played Offensive Fouls Offensive Rating Offensive Rebounds Offensive Rebounds Percentage Personal Fouls Plus Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage Points Off Turnovers Rebounds |
Rebounds Percentage Second Chance Attempts Second Chance Made Second Chance Percentage Second Chance Points Steals Steals Percentage Technical Fouls Three Points Attempted Three Points Made Three Points Percentage True Shooting Attempts True Shooting Percentage Turnovers Turnovers Percentage Two Points Attempted Two Points Made Two Points Percentage |
| Team Period Statistics Data Points: | Assists Assists To Turnover Ratio Bench Points Biggest Lead Blocked Attempts Blocked Shots Defensive Points per Possession Defensive Rating Defensive Rebounds Effective Field Goal Percentage Efficiency Efficiency Game Score Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goals Attempted Field Goals Made Field Goals Percentage Flagrant Fouls Fouls Drawn Free Throw Attempts |
Free Throw Made Free Throw Percentage Minutes Played Offensive Fouls Offensive Points per Possession Offensive Rating Offensive Rebounds Opponent Possessions Personal Fouls Player Technical Fouls Plus/Minus Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage Points Off Turnovers Possessions Rebounds Second Chance Attempts Second Chance Made |
Second Chance Percentage Second Chance Points Steals Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Rebounds Team Technical Fouls Team Turnovers Three Points Attempted Three Points Made Three Points Percentage Time Leading Total Fouls Total Rebounds True Shooting Attempts True Shooting Percentage Turnovers Two Points Attempted Two Points Made Two Points Percentage |
| Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Percentage Double Double Effective Field Goal Percentage Efficiency Efficiency Game Score Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Foul Outs |
Fouls Drawn Free Throw Attempts Free Throw Percentage Free Throws Made Minus Minutes Played Offensive Fouls Offensive Rebounds Offensive Rebounds Percentage Personal Fouls Plus Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage Points off Turnovers Rebounds Rebounds Percentage Second Chance Attempts |
Second Chance Made Second Chance Percentage Second Chance Points Steals Steals Percentage Technical Fouls Three Point Attempts Three Point Percentage Three Points Made True Shooting Attempts True Shooting Percentage Triple Double Turnovers Turnovers Percentage Two Point Attempts Two Point Percentage Two Points Made |
| Team Game Statistics Data Points: | Assists Assists To Turnover Ratio Bench Points Biggest Lead Blocked Attempts Blocked Shots Coach Ejections Coach Technical Fouls Defensive Points per Possession Defensive Rating Defensive Rebounds Effective Field Goal Percentage Efficiency Efficiency Game Score Ejections Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Foul Outs Fouls Fouls Drawn Free Throw Attempts |
Free Throw Percentage Free Throws Made Minutes Played Most Unanswered Point Most Unanswered Points Opponents Score Most Unanswered Points Own Score Offensive Fouls Offensive Points per Possession Offensive Rating Offensive Rebounds Opponents Possession Personal Fouls Player Technical Fouls Plus/Minus Points Points Against Points In the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage Points off Turnovers Rebounds Second Chance Attempts |
Second Chance Made Second Chance Percentage Second Chance Points Steals Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Rebounds Team Technical Fouls Team Turnovers Three Point Attempts Three Point Percentage Three Points Made Time Leading Total Rebounds True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made |
| Lineups Data Points: | Active Fouled Out |
Played | Started |
| Player Data Points: | First Name Full Name Id |
Jersey Number Last Name Position |
Primary Position Reference |
| Team Data Points: | Alias Coach First Name Coach Full Name Coach Id |
Coach Last Name Coach Position Id |
Market Name Reference |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias | Id | Name |
| Player Data Points: | First Name Full Name Id Injuries Comment Injuries Description |
Injuries Id Injuries Start Date Injuries Status Injuries Update Date |
Jersey Number Last Name Position Primary Position Reference |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias Conference Alias |
Conference Id Conference Name |
Id Name |
| Team Data Points: | Alias Id |
Market Name |
Reference |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Season Id Season Type |
Season Year Association Alias |
Leaders Id Association Name |
| League Leaders Data Points: | Assists Assists Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Category Name Category Type Defensive Rebounds Defensive Rebounds Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Free Throw Attempts |
Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Player Rank Points Points Per Game Rebounds Rebounds Per Game Stat Category |
Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Tied Flag Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Player Data Points: | First Name Full Name Jersey Number |
Last Name Player Id Position |
Primary Position Reference |
| Player Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Double Double Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Breaks Attempted Fast Breaks Attempted Per Game Fast Breaks Percentage Fast Breaks Points Fast Breaks Points per Game Fast Breaks Made Fast Breaks Made Per Game Field Goals Attempted Field Goals Attempted Per Game Field Goals Made Field Goals Made Per Game Field Goals Percentage Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throws Attempted Free Throws Attempted Per Game Free Throws Made Free Throws Made Per Game Free Throws Percentage Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chances Attempted Second Chances Attempted Per Game Second Chances Made Second Chances Made Per Game Second Chances Percentage Second Chances Points Second Chances Points Per Game Steals Steals Per Game Technical Fouls Three Points Attempted Three Points Attempted Per Game Three Points Made Three Points Made Per Game Three Points Percentage Triple Double True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Points Attempted Two Points Attempted Per Game Two Points Made Two Points Made Per Game Two Points Percentage |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Boxscore Data Points: | Attendance Clock Duration Lead Changes |
Quarter Quarter Lead Changes Quarter Number |
Quarter Sequence Times Tied |
| Game Data Points: | Away Team Id Away Team Reference Coverage Entry Mode Home Team Id |
Home Team Reference Id Neutral Site Reference |
Scheduled Date And Time Status Title Track on Court |
| Play-By-Play Data Points: | Attribution Team Id Attribution Team Market Attribution Team Name Attribution Team Reference Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Quarter Score Away Team Reference Basket Team is Defending Event Attempt Event Clock Event Description Event Id Event Location Action Area Event Location X Coordinate Event Location Y Coordinate Event Number |
Event Participants Player Full Name Event Participants Player Id Event Participants Player Jersey Number Event Participants Player Reference Event Participants Team Id Event Participants Team Market Event Participants Team Name Event Participants Team Reference Event Turnover Type Event Type Event Updated Fieldgoal Made Flag Fieldgoal Points Fieldgoal Shot Distance Fieldgoal Shot Type Fieldgoal Shot Type Description Fieldgoal Three Point Shot Freethrow Free Throw Type Freethrow Made Flag Freethrow Points |
Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Overtime Score Home Team Quarter Score Home Team Reference Overtime Id Overtime Number Overtime Sequence Possession Team Id Possession Team Market Possession Team Name Possession Team Reference Quarter Id Quarter Number Quarter Sequence Rebound Type Scoring Lead Changes Scoring Times Tied |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias Id |
Name Season Id |
Season Type Season Year |
| Player Data Points: | Abbreviated Name Birth Date Birth Place College Draft Pick Draft Round Draft Team |
Draft Year Experience First Name Full Name Height (in) Id Jersey Number |
Last Name Position Primary Position Reference Status Updated Timestamp Weight (lbs) |
| Player Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Double Double Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Breaks Attempted Fast Breaks Attempted Per Game Fast Breaks Percentage Fast Breaks Points Fast Breaks Points per Game Fast Breaks Made Fast Breaks Made Per Game Field Goals Attempted Field Goals Attempted Per Game Field Goals Made Field Goals Made Per Game Field Goals Percentage Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throws Attempted Free Throws Attempted Per Game Free Throws Made Free Throws Made Per Game Free Throws Percentage Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chances Attempted Second Chances Attempted Per Game Second Chances Made Second Chances Made Per Game Second Chances Percentage Second Chances Points Second Chances Points Per Game Steals Steals Per Game Technical Fouls Three Points Attempted Three Points Attempted Per Game Three Points Made Three Points Made Per Game Three Points Percentage Triple Double True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Points Attempted Two Points Attempted Per Game Two Points Made Two Points Made Per Game Two Points Percentage |
| Team Data Points: | Alias Id |
Market Name |
Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias Conference Alias Conference Id |
Conference Name Id Name |
Season Id Season Type Season Year |
| Standings Data Points: | Conference Rank | Playoff Status | |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| Game Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Away Team Seed Number Broadcast Cable Broadcast Internet |
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Reference |
Home Team Seed Number Id Neutral Site Reference Scheduled Date and Time Status Title Track on Court |
| League Data Points: | Id Name |
Season Id Season Type |
Season Year |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Season Id | Season Type | Season Year |
| Player Data Points: | First Name Full Name Id |
Jersey Number Last Name Position |
Primary Position Reference |
| Opponent Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts |
Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Technical Fouls Technical Other Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Player Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Double Double Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Breaks Attempted Fast Breaks Attempted Per Game Fast Breaks Percentage Fast Breaks Points Fast Breaks Points per Game Fast Breaks Made Fast Breaks Made Per Game Field Goals Attempted Field Goals Attempted Per Game Field Goals Made Field Goals Made Per Game Field Goals Percentage Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throws Attempted Free Throws Attempted Per Game Free Throws Made Free Throws Made Per Game Free Throws Percentage Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chances Attempted Second Chances Attempted Per Game Second Chances Made Second Chances Made Per Game Second Chances Percentage Second Chances Points Second Chances Points Per Game Steals Steals Per Game Technical Fouls Three Points Attempted Three Points Attempted Per Game Three Points Made Three Points Made Per Game Three Points Percentage Triple Double True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Points Attempted Two Points Attempted Per Game Two Points Made Two Points Made Per Game Two Points Percentage |
| Team Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game |
Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Technical Fouls Technical Other Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| Game Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Away Team Seed Number Broadcast Cable Broadcast Internet |
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name Away Team Points Away Team Reference |
Home Team Seed Number Id Neutral Site Reference Scheduled Date And Time Status Title Track on Court |
| League Data Points: | Alias Id |
Name Season Id |
Season Type Season Year |
| Series Data Points: | Id Participant Name Participant Record |
Participant Seed Round Start Date |
Status Title |
| Team Data Points: | Alias Id |
Market Name |
Reference |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Season Id | Season Type | Season Year |
| Player Data Points: | First Name Full Name Id |
Jersey Number Last Name Position |
Primary Position Reference |
| Opponent Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts |
Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Technical Fouls Technical Other Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Player Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Double Double Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Breaks Attempted Fast Breaks Attempted Per Game Fast Breaks Percentage Fast Breaks Points Fast Breaks Points per Game Fast Breaks Made Fast Breaks Made Per Game Field Goals Attempted Field Goals Attempted Per Game Field Goals Made Field Goals Made Per Game Field Goals Percentage Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throws Attempted Free Throws Attempted Per Game Free Throws Made Free Throws Made Per Game Free Throws Percentage Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chances Attempted Second Chances Attempted Per Game Second Chances Made Second Chances Made Per Game Second Chances Percentage Second Chances Points Second Chances Points Per Game Steals Steals Per Game Technical Fouls Three Points Attempted Three Points Attempted Per Game Three Points Made Three Points Made Per Game Three Points Percentage Triple Double True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Points Attempted Two Points Attempted Per Game Two Points Made Two Points Made Per Game Two Points Percentage |
| Team Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Foul Outs Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempted Points in the Paint Attempted Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game |
Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Technical Fouls Technical Other Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias Conference Alias Conference Id |
Conference Name Id Name |
Season Id Season Type Season Year |
| Standings Data Points: | Conference Losses Conference Winning Percentage Conference Wins Games Behind Conference Games Behind League Games Decided by 10 pts or More Losses Games Decided by 10 pts or More Winning Percentage Games Decided by 10 pts or More Wins Games Decided by 3 pts or Less Losses Games Decided by 3 pts or Less Winning Percentage Games Decided by 3 pts or Less Wins Home Losses Home Winning Percentage Home Wins |
Last 10 Games Losses Last 10 Games Winning Percentage Last 10 Games Wins Last 10 Home Games Losses Last 10 Home Games Winning Percentage Last 10 Home Games Wins Last 10 Road Games Losses Last 10 Road Games Winning Percentage Last 10 Road Games Wins Overall Losses Overall Point Differential Overall Points Against Overall Points For Overall Winning Percentage |
Overall Wins Overtime Losses Overtime Winning Percentage Overtime Wins Road Losses Road Winning Percentage Road Wins Streak Versus Teams Above 500 Losses Versus Teams Above 500 Winning Percentage Versus Teams Above 500 Wins Versus Teams Below 500 Losses Versus Teams Below 500 Winning Percentage Versus Teams Below 500 Wins |
| Team Data Points: | Id Market |
Name | Reference |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| League Data Points: | Alias Conference Alias |
Conference Id Conference Name |
Id Name |
| Player Data Points: | Abbreviated Name Birth Date Birth Place College Draft Pick Draft Round Draft Team Draft Year Experience |
First Name Full Name Height (in) Id Injuries Comment Injuries Description Injuries Id Injuries Start Date Injuries Status |
Injuries Update Date Jersey Number Last Name Position Primary Position Reference Status Updated Weight (lbs) |
| Team Data Points: | Alias Coach Experience Coach First Name Coach Full Name |
Coach Id Coach Last Name Coach Position Id |
Market Name Reference Year Founded |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
For Java, we have also provided a Stream Client to assist your integration.
Note: In the provided Java sample, replace "URL GOES HERE" with the desired Push feed URL. ```ruby require 'httpclient' module Sportradar module HTTP module Stream class Client attr_reader :url, :logger def initialize(url, publisher, logger) @url = url @logger = logger @publisher = publisher @client = ::HTTPClient.new(:agent_name => 'SportsData/1.0') end def start @thread ||= Thread.new do logger.debug "Starting loop" @client.get_content(url, :follow_redirect => true) do |chunk| @publisher.publish(::JSON.parse(chunk)) if @publisher end logger.debug "finished loop" end end def stop @thread.terminate if @thread end end end end end ``` ```java package com.sportradar.http.stream.client; import org.junit.After; import org.junit.Before; import org.junit.Test; public class StreamClientTest { private StreamClient client; private static String SERVICE_URL = "
| 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. |
Example: locale:en | | `match` | Match id expressed as: sd:match:{match_id}.
Example: sd:match:0144c46e-e830-4082-8558-933a21923e60 | | `operation` | Update (update), delete (delete), or insert (insert). | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Push Events ```ruby 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 ``` ```python 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/events/subscribe?api_key={your_api_key}' ``` >The above command returns json like this. This endpoint retrieves detailed, real-time information on every game event. https://api.sportradar.us/wnba/`{access_level}`/stream/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). | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby 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:0144c46e-e830-4082-8558-933a21923e60") 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 ``` ```python 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:0144c46e-e830-4082-8558-933a21923e60'}, 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60' ``` 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.
| 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. |
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:0144c46e-e830-4082-8558-933a21923e60 | | `operation` | Update (update), delete (delete), or insert (insert). | | `players` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:e49da6d1-dd65-44f9-9a5f-d60010d8c384 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:6f017f37-be96-4bdc-b6d3-0a0429c72e89 | Return to API map ## Push Statistics ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/wnba/trial/stream/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 ``` ```python import requests import json r = requests.get("https://api.sportradar.com/wnba/trial/stream/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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}' ``` > The above command returns json like this. This endpoint retrieves detailed, real-time game stats at the team and player level for all live games. https://api.sportradar.us/wnba/`{access_level}`/stream/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). | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60") 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 ``` ```python import requests import json r = requests.get("https://api.sportradar.com/wnba/trial/stream/statistics/subscribe", params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:0144c46e-e830-4082-8558-933a21923e60'}, 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)) ``` ```shell curl -L GET 'api.sportradar.us/wnba/trial/stream/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0144c46e-e830-4082-8558-933a21923e60' ``` 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.
| 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. |
Example: locale:en | | `match` | Match id expressed as: sd:match:{match_id}.
Example: sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40 | | `operation` | Update (update), delete (delete), or insert (insert). | | `player` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:e49da6d1-dd65-44f9-9a5f-d60010d8c384 | | `stats_type` | Stat type expressed as {stats_type}. Example: stats_type=player | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:6f017f37-be96-4bdc-b6d3-0a0429c72e89 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Frequently Asked Questions
Q: What format are date fields presented in?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What format are the date/time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What game statuses can I expect to see in the feeds and what are their definitions?
A: Here is a list of the valid game statuses you can expect to see, and their definitions.
- scheduled - The game is scheduled to occur.
- created – The game has been created and we have begun logging information.
- inprogress – The game is in progress.
- halftime - The game is currently at halftime.
- complete – The game is over, but stat validation is not complete.
- closed – The game is over and the stats have been validated.
- cancelled – The game has been cancelled. No makeup game will be played as a result.
- delayed – The start of the game is currently delayed or the game has gone from in progress to delayed for some reason.
- postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
- time-tbd – The game has been scheduled, but a time has yet to be announced.
- if-necessary – The game will be scheduled if it is required.
- unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
Q: What player positions can I expect to see in the feeds?
A: Here is a list of the valid player positions you can expect to see.
- NA
- C
- C-F
- F
- F-C
- F-G
- G
- G-F
Q: What player statuses can I expect to see in the feeds?
A: Here is a list of the valid player statuses you can expect to see.
- ACT – The player is on the team’s active roster
- SUS – The player is suspended
- IR – The player is on injured reserve
- NWT – The player is no longer with the team
- FA – Free Agent
- RET – Retired
Q: What player injury statuses can I expect to see in the feeds?
A: Here is a list of the valid player injury statuses you can expect to see.
- Unknown
- Day to Day
- Out
- Out for Season
- Out Indefinitely
Q: What shot type descriptions can I expect to see in the feeds?
A: Here is a list of the valid shot types with the descriptions you can expect to see for each shot type.
Jump Shot (This is the only shot type for 3-point attempts)
- bank
- driving
- driving bank
- driving floating
- driving floating bank
- turnaround
- turnaround bank
- turnaround fadeaway
- turnaround fadeaway bank
- floating
- fadeaway
- fadeaway bank
- stepback
- stepback bank
- pullup
- pullup bank
- running
- running pullup
Layup
- alley-oop
- cutting
- cutting finger roll
- driving
- driving reverse
- driving finger roll
- finger roll
- putback
- reverse
- running
- running reverse
- running finger roll
- running alley-oop
- tip
Dunk
- alley-oop
- tip
- driving
- driving reverse
- putback
- running
- reverse
- running reverse
- running alley-oop
- cutting
Tip Shot
Hook
- bank
- driving
- driving bank
- turnaround
- turnaround bank
Q: What are the valid turnover type descriptions I can expect to see in the feeds?
A: Here is a list of the valid turnover types you can expect to see.
- Traveling
- Bad Pass
- Lost Ball
- Carrying
- Palming
- Out of Bounds
- Lost Ball
- Step
- Bad Pass
- Double Dribble
- Offensive Goaltending
- 3-second violation
- 5-second violation
- 8-second violation
- 10-second violation
- Back Court Violation
- Shot Clock Violation
- Lane Violation
- Illegal Assist
- Illegal Screen
- Turnover
- Too Many Players
- Excess Timeout
- Basket from Below
- Swinging Elbows
- Offensive Foul
- Punched Ball
- Opposite Basket
- Jump Ball Violation
- Inbound
- Discontinue Dribble
- 5-second Violation Inbound
- Kicked ball Violation
- 5-second Violation Back to the Basket
Q: What are the valid stoppage reasons I can expect to see in the feeds?
A: Here is a list of the valid stoppage reasons you can expect to see.
- Out of Bounds
- Equipment Malfunction
- Blood Rule
- Court Cleanup
- Injury
- Other
Q: What are the valid jump ball reasons I can expect to see in the feeds?
A: Here is a list of the valid jump ball reasons you can expect to see.
- Lodged Ball
- Held Ball
- Double Violation
- Unclear Pass
- Double Foul
Q: What are the valid foul type descriptions I can expect to see in the feeds?
A: Here is a list of the valid foul type descriptions you can expect to see.
- Charge
- Off the Ball
- Block
- Take
- Double
- Shooting
- Clear Path
- Loose Ball
- Blocking
- Player Control
- Shooting block
- Elbowing
- Punching
- Flagrant One
- Flagrant Two
- Away from Play
- Unsportsmanlike Conduct
- Rim Hanging
- Delay of Game
- Taunting
- Indirect
- Excess Timeout
- Too Many Players
- Inbound
- Defensive Three Second
- Flopping
Q: What are the valid free throw types I can expect to see in the feeds?
A: Here is a list of the valid free throw types you can expect to see.
- Regular
- Technical
- Flagrant
- Clear Path
Q: What ejection types can I expect to see in the feeds?
A: Here is a list of the valid ejection types you can expect to see.
- Technical
- Second Technical
- Second Flagrant Type 1
- Flagrant Type 2
- Other
Q: Are there cases when not all game data is available?
A: Yes, in cases when Sportradar is unable to receive data from the venue, Sportradar's in-house operators will take over coverage of the game. In these cases, the following data points will not be available or will not update during the game.
- Defensive Points per Possession
- Defensive Rating
- Defensive Rebounds Percentage
- Fast Break Attempts
- Fast Break Made
- Fast Break Percentage
- Minus
- Offensive Points per Possession
- Offensive Rating
- Offensive Rebounds Percentage
- Opponent Possessions
- Plus
- Rebounds Percentage
- Second Chance Attempts
- Second Chance Made
- Second Chance Percentage
- Team Defensive Rebounds
- Team Offensive Rebounds
- Time Spent Leading
- Turnovers Percentage
After the game, when on-venue data can be received again, these fields will be updated.
Q: What is the scale of the X Y coordinates?
A: The court we use is 1128 by 600. The scale is in inches. Here is a layout of the court:
| 0 | X | 1128 | ||
|---|---|---|---|---|
| Y | ||||
| 600 |
Q: What x/y vertices define action areas in the x/y coordinate graph?
A: A list of areas is included below. Note that these vertices are for the left side of the court. For the right side, we use the following calculation, where length=1128 and width=600:
- right-court-point = (length - x, width - y)
- left_basket=[63, 300]
- right_basket=[1065, 300]
Areas:
- underbasket: [ 48, 252 ], [ 77, 258 ], [ 111, 300 ], [ 77, 342 ], [ 48, 348 ]
- inthepaint: [ 0, 204 ], [ 228, 204 ], [ 228, 396 ], [ 0, 396 ]
- insiderightwing: [ 0, 36 ], [ 115, 36 ], [ 77, 204 ], [ 0, 204 ]
- insideright: [ 115, 36 ], [ 225, 87 ], [ 294, 161 ], [ 225, 204 ], [ 77, 204 ]
- insidecenter: [ 225, 204 ], [ 294, 161 ], [ 324, 218 ], [ 337, 300 ], [ 324, 382 ], [ 294, 439 ], [ 225, 396 ]
- insideleft: [ 115, 564 ], [ 225, 513 ], [ 294, 439 ], [ 225, 396 ], [ 77, 396 ]
- insideleftwing: [ 0, 564 ], [ 115, 564 ], [ 77, 396 ], [ 0, 396 ]
- outsiderightwing: [ 0, 0 ], [ 122, 0 ], [ 115, 36 ], [ 0, 36 ]
- outsideright: [ 122, 0 ], [ 492, 0 ], [ 492, 69 ], [ 324, 218 ], [ 294, 161 ], [ 225, 87 ], [ 115, 36 ]
- outsidecenter: [ 324, 216 ], [ 492, 69 ], [ 492, 531 ], [ 324, 382 ], [ 337, 300 ]
- outsideleft: [ 122, 600 ], [ 492, 600 ], [ 492, 531 ], [ 324, 382 ], [ 294, 439 ], [ 225, 513 ], [ 115, 564 ]
- outsideleftwing: [ 0, 600 ], [ 122, 600 ], [ 115, 564 ], [ 0, 564 ]
- backcourt: [ 492, 0 ], [ 564, 0 ], [ 564, 600 ], [ 492, 600 ]
Q: Why does the team_basket attribution in the play-by-play feed not match the basket orientation (left vs. right) in the broadcast or game tracking that I'm viewing?
A: Our team_basket attribution is set to match the orientation of the local television broadcast, which is on the opposite side of the scorer's table. The team_basket attribution may not match the orientation used by the particular broadcast or game tracker that you are viewing.
If you want to provide a perspective from the scorer's table, you will have to map the coordinates so that the coordinates attributed to left side of the court are attributed to the right side of the court on your end (and vice versa).
Q: What are the valid events types tracked in the play by play feed?
A: Here is a list of the valid event types you can expect to see.
- clearpathfoul - <charged_to> clear path foul (<drawn_by> draws the foul)
- deadball - <given_to> rebound (deadball)
- defaultviolation - <charged_to> violation
- defensivegoaltending - <charged_to> defensive goaltending violation
- delay - <charged_to> delay of game violation
- doublelane - <charged_to> double lane violation
- ejection - <given_to> ejected from the game (<ejection_type>)
- endperiod - End of <nth period/half>
- flagrantone - <charged_to> flagrant 1 (<drawn_by> draws the foul)
- flagranttwo - <charged_to> flagrant 2 (<drawn_by> draws the foul)
- freethrowmade - <taken_by> makes <free_throw_type> free throw <attempt>
- freethrowmiss - <taken_by> misses <free_throw_type> free throw <attempt> (<charged_to> lane_violation)
- jumpball - Jump ball <reason>. <possessor> vs <challenger> (<possession> gains possession)
- jumpballviolation - <charged_to> jump ball violation
- kickball - <charged_to> kicked ball violation
- lane - <charged_to> lane violation
- lineupchange - <team_name> lineup change (<players>)
- offensivefoul - <charged_to> offensive foul (<foul_type_desc>) (<drawn_by> draws the foul)
- officialtimeout - Official timeout
- openinbound - Open inbound <team_name>
- opentip - Jump ball. <home> vs <away> (<possession> gains possession)
- personalfoul - <charged_to> personal foul (<foul_type_desc>) (<drawn_by> draws the foul)
- possession - <possession> gain possession
- rebound - <given_to> <offensive/defensive> rebound
- review - Play review (<reason>, <outcome>)
- shootingfoul - <charged_to> shooting foul (<drawn_by> draws the foul)
- stoppage - Stoppage (<reason>)
- teamtimeout - <team_name> <duration> second timeout
- technicalfoul - <charged_to> technical foul (<foul_type_desc>)
- threepointmade - <taken_by> makes three point <shot_type_desc> <shot_type> (<assisted_by> assists)
- threepointmiss - <taken_by> misses three point <shot_type_desc> <shot_type>
- turnover - <charged_to> turnover (turnover_type_desc>)
- tvtimeout - TV Timeout
- twopointmade - <taken_by> makes two point <shot_type_desc> <shot_type> (<assisted_by> assists)
- twopointmiss - <taken_by> misses two point <shot_type_desc> <shot_type>
Q: What are the valid playoff statuses and their definitions?
A: Here is a list of the valid playoff statuses and their definitions:
- conference – The team has clinched the best record home court advantage for the playoffs.
- eliminated – The team has been eliminated from playoff contention.
- playoff_berth – The team has clinched a playoff berth.
Q: When are scores added to the schedule feeds?
A: Final scores are added to the schedule feeds when the game status changes to completed.
Q: What are the possible values for event category used in the Push Events feed?
A: Here is a list of the valid event categories you can expect to see.
- freethrow
- freethrow,score
- foul
- foul,flagrant
- foul,warning
- lineupchange
- period,stoppage
- period,stoppage,possession
- possession
- shot
- shot,score
- stoppage
- timeout,stoppage
- turnover
- violation
Q: What are the possible values for statistics type used in the Push Events feed?
A: Here is a list of the valid statistics types you can expect to see.
- fieldgoal
- assist
- block
- attemptblocked
- rebound
- freethrow
- turnover
- steal
- personalfoul
- flagrantfoul
- technicalfoul
- ejection
- fouldrawn
- offensivefoul
Q: What formulas are used to calculate efficiency and efficiency game score?
A: Here are the formulas we use:
Efficiency: (Points + Rebounds + Assists + Steals + Blocks − Missed Field Goal Attempts − Missed Free Throw Attempts - Turnovers)
Efficiency Game Score: (Points) + (0.4*Field Goals Made) - (0.7*Field Goals Attempted) - (0.4*Free Throws Missed) + (0.7*Offensive Rebounds) + (0.3*Defensive Rebounds) + (Steals) + (0.7*Assists) + (0.7*Blocks) – (0.4*Personal Fouls) – (Turnovers)
Note: For this team efficiency calculations, statistics attributed to the team rather than a player are not counted (i.e. team rebounds, team turnovers, team fouls, etc.).
Q: What are the possible values for player – not_playing_reason?
A: Here is a list of the valid not playing reasons you can expect to see, and their descriptions.
- DNP - Coaches Decision
- DNP - Injury/Illness
- DNP - Personal
- DNP - Rest
- DNP - Trade Pending
- DNP - League Suspension
- DNP - Team Suspension
- DNP - Return to Competition Reconditioning
- DNP - Ineligible to Play
- DNP - Health and Safety Protocols
- DND - Coaches Decision
- DND - Injury/Illness
- DND - Personal
- DND - Rest
- DND - Trade Pending
- DND - League Suspension
- DND - Team Suspension
- DND - Return to Competition Reconditioning
- DND - Ineligible to Play
- DND - Health and Safety Protocols
- NWT - Coaches Decision
- NWT - Injury/Illness
- NWT - Personal
- NWT - Rest
- NWT - Trade Pending
- NWT - League Suspension
- NWT - Team Suspension
- NWT - Return to Competition Reconditioning
- NWT - Ineligible to Play
- NWT - Health and Safety Protocols
- NWT - Not With Team
- Inactive - Injury/Illness
- Inactive - Personal
- Inactive - Rest
- Inactive - Suspended
- Inactive - Trade Pending
- Inactive - Coaches Decision
- Inactive - G League Team
- Inactive - G League - On Assignment
- Inactive - G League - Two-Way
- Inactive - Not With Team
- Inactive - Team Suspension
- Inactive - League Suspension
- Inactive - Health and Safety Protocols
- Inactive - Return to Competition Reconditioning
- Inactive - NWT Return to Competition Reconditioning
- Inactive - Ineligible to Play
Docs Navigation
- Documentation
- Football (American Football)
- Football (Soccer)
- Australian Rules Football
- Baseball
- Basketball
- Combat Sports
- Cricket
- Editorial Content
- Golf
- Handball
- Hockey
- Images
- Insights
- Betting Insights
- Odds
- Racing
- Rugby
- Tennis
- Widgets
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v2
- Bandy v1
- Beach Soccer v2
- Beach Soccer v1
- Curling v2
- Curling v1
- Cycling v2
- Cycling v1
- Darts v2
- Darts v1
- Field Hockey v2
- Field Hockey v1
- Floorball v2
- Floorball v1
- Futsal v2
- Futsal v1
- Pesapallo v2
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v2
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v2
- Waterpolo v1
- Winter Sports v1
