WNBA v3
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
Information on any changes made to teams, players, game statistics, and standings.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/league/2015/07/21/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-t3/league/2015/07/21/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-t3/league/2015/07/21/changes.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Daily Change Log.
https://api.sportradar.us/wnba-`{access_level}{version}`/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/changelog-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Daily Schedule
Date, time, location, and other event details for every match-up taking place in the league-defined day.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/games/2015/07/21/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-t3/games/2015/07/21/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-t3/games/2015/07/21/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
To access the Daily Schedule, replace the parameters in the following URL:
https://api.sportradar.us/wnba-`{access_level}{version}`/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
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-t3/league/2015/07/21/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-t3/league/2015/07/21/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-t3/league/2015/07/21/transfers.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Daily Transfers.
https://api.sportradar.us/wnba-`{access_level}{version}`/league/`{year}`/`{month}`/`{day}`/transfers.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/transfers-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Free Agents
Information for all WNBA free agents.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/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-t3/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-t3/league/free_agents.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Free Agents.
https://api.sportradar.us/wnba-`{access_level}{version}`/league/free_agents.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/free-agents-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Boxscore
Top-level team scores by quarter along with full statistics for each team‘s leaders in points, rebounds, and assists.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/boxscore.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Game Boxscore information for a specific game.
https://api.sportradar.us/wnba-`{access_level}{version}`/games/`{game_id}`/boxscore.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/game-v2.0.xsd?api_key=`{your_api_key}`
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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Game Summary information for a specific game.
https://api.sportradar.us/wnba-`{access_level}{version}`/games/`{game_id}`/summary.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/game-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Injuries
Information concerning all active player injuries for all teams within the league.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/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-t3/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-t3/league/injuries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves player Injuries.
https://api.sportradar.us/wnba-`{access_level}{version}`/league/injuries.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/injuries-v2.0.xsd?api_key=`{your_api_key}`
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-t3/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-t3/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-t3/league/hierarchy.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the League Hierarchy.
https://api.sportradar.us/wnba-`{access_level}{version}`/league/hierarchy.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/wnba/hierarchy-v2.0.xsd?api_key=`{your_api_key}`
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-t3/seasontd/2015/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-t3/seasontd/2015/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-t3/seasontd/2015/REG/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the League Leaders.
https://api.sportradar.us/wnba-`{access_level}{version}`/seasontd/`{season_year}`/`{wnba_season}`/leaders.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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 League Leaders, replace the parameters in the following URL.
https://api.sportradar.us/wnba-`{access_level}{version}`/schema/wnba/hierarchy-v2.0.xsd?api_key=`{your_api_key}`
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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/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-t3/games/79210623-0c29-4c8a-821f-c220657125f7/pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Play-By-Play for a game.
https://api.sportradar.us/wnba-`{access_level}{version}`/games/`{game_id}`/pbp.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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:///api.sportradar.us/wnba-`{access_level}{version}`/schema/pbp-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Player Profile
Detailed player information including a current look at the player’s statistics for the current season.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/players/b404562d-a1fd-446f-bcd0-6b545dfde9c6/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-t3/players/b404562d-a1fd-446f-bcd0-6b545dfde9c6/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-t3/players/b404562d-a1fd-446f-bcd0-6b545dfde9c6/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Player Profile.
https://api.sportradar.us/wnba-`{access_level}{version}`/players/`{player_id}`/profile.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/profile-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Rankings
Conference and division rank for each team, including post season clinching status.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/seasontd/2015/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-t3/seasontd/2015/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-t3/seasontd/2015/REG/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the current Rankings.
https://api.sportradar.us/wnba-`{access_level}{version}`/seasontd/`{season_year}`/`{wnba_season}`/rankings.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/wnba/rankings-v2.0.xsd?api_key=`{your_api_key}`
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-t3/games/2015/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-t3/games/2015/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-t3/games/2015/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Schedule.
https://api.sportradar.us/wnba-`{access_level}{version}`/games/`{season_year}`/`{wnba_season}`/schedule.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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 Schedule, replace the parameters in the following URL.
https://api.sportradar.us/wnba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Seasonal Statistics (Season To Date)
Detailed team and player statistics for the defined season.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/seasontd/2015/REG/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/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-t3/seasontd/2015/REG/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/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-t3/seasontd/2015/REG/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Seasonal Statistics for a given team.
https://api.sportradar.us/wnba-`{access_level}{version}`/seasontd/`{season_year}`/`{wnba_season}`/teams/`{team_id}`/statistics.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `season_year` | Year in 4 digit format (YYYY). |
| `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 Seasonal Statistics, replace the parameters in the following URL.
https://api.sportradar.us/wnba-`{access_level}{version}`/schema/statistics-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Series Schedule
Play-off participant information as well as the date, time, location, and other event details for every match-up taking place for the entire play-offs.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/series/2015/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-t3/series/2015/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-t3/series/2015/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Series Schedule.
https://api.sportradar.us/wnba-`{access_level}{version}`/series/`{season_year}`/`{wnba_season}`/schedule.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
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-t3/seasontd/2013/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-t3/seasontd/2013/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-t3/seasontd/2013/REG/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the current Standings.
https://api.sportradar.us/wnba-`{access_level}{version}`/seasontd/`{season_year}`/`{wnba_season}`/standings.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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 Standings, replace the parameters in the following URL.
https://api.sportradar.us/wnba-`{access_level}{version}`/schema/wnba/standings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Team Profile (Rosters)
Detailed team information including league affiliation information as well as player roster information.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/wnba-t3/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/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-t3/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/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-t3/teams/e6bc56cc-9dad-43aa-8ccb-ee9d499fea28/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Team Profile.
https://api.sportradar.us/wnba-`{access_level}{version}`/teams/`{team_id}`/profile.`{format}`?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 (p) or Trial (t). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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://api.sportradar.us/wnba-`{access_level}{version}`/schema/team-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Frequently Asked Questions
| API | API Version |
| Women's National Basketball Association | v3 |
| 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 | Title | Updated Timestamp |
| League Data Points: | Alias Id |
Name | Season |
| Player Data Points: | Full Name | Id | Updated Timestamp |
| Team Data Points: | Id Market |
Name |
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 Rotation Number 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 Rotation Number Home Team Seed Number Id Neutral Site Scheduled Date and Time Status Title |
| 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 |
Transfers Description Transfers Effective Date Transfers End Date Transfers Id Transfers New Team Id Transfers New Team Market Transfers New Team Name |
Transfers Notes Transfers Old Team Id Transfers Old Team Market Transfers Old Team Name 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 Status Weight (lbs) |
| Update Frequency: | As Necessary | ||
| 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 Clock Duration |
Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Quarter Score 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 Coverage Home Team Id |
Id Neutral Site Scheduled Time And Date |
Status Title |
| Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rebounds Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls |
Free Throw Attempts Free Throw Percentage Free Throws Made Minutes Played Offensive Rebounds Personal Fouls Plus/Minus Points Rebounds |
Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Turnovers Two Point Attempts Two Point Percentage Two Points Made |
| Player Data Points: | Full Name Id |
Jersey Number Position |
Primary Position |
| Update Frequency: | As Necessary | ||
| 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 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 Lead Changes Quarter Quarter Number Quarter Sequence Times Tied |
| Game Data Points: | Away Team Id Coverage Home Team Id |
Id Neutral Site Scheduled Date And Time |
Status Title |
| Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rebounds Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Foul Outs |
Free Throw Attempts Free Throw Percentage Free Throws Made Minutes Played Offensive Rebounds Personal Fouls Plus/Minus Points Rebounds |
Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Turnovers Two Point Attempts Two Point Percentage Two Points Made |
| Team Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Coach Technical Fouls Defensive Rebounds Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Foul Outs Free Throw Attempts |
Free Throw Percentage Free Throws Made Minutes Played Offensive Rebounds Personal Fouls Points Points In the Paint Points off Turnovers Rebounds Second Chance Points Steals |
Team Rebounds Team Technical Fouls Team Turnovers Three Point Attempts Three Point Percentage Three Points Made Total Player Technical Fouls 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 Injuries Comment Injuries Description |
Injuries Id Injuries Start Date Injuries Status Injuries Update Date |
Jersey Number Last Name Position Primary Position |
| 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 |
| Team Data Points: | Id | Market | Name |
| 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 |
| 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 |
| 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 Defensive Rebounds Defensive Rebounds Per Game Ejections 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 Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds Per Game 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 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 |
| Update Frequency: | As Necessary | ||
| Content Type: | XML or JSON | ||
| Boxscore Data Points: | Attendance Clock Duration |
Lead Changes Quarter Quarter Number |
Quarter Sequence Times Tied |
| Game Data Points: | Away Team Id Coverage Home Team Id |
Id Neutral Site Scheduled Date And Time |
Status Title |
| Play-By-Play Data Points: | Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Quarter Score Basket Team is Attacking Event Attempt Event Clock Event Description Event Free Throw Type Event Id Event Insert/Update Time Event Location X Coordinate Event Location Y Coordinate |
Event Participants Player Full Name Event Participants Player Id Event Participants Player Jersey Number Event Participants Team Id Event Participants Team Market Event Participants Team Name Event Shot Type Event Shot Type Description Event Turnover Type Event Type Home Team Game Score Home Team Id Home Team Market Home Team Name |
Home Team Overtime Score Home Team Quarter Score Possession Team Id Possession Team Market Possession Team Name Overtime Id Overtime Number Overtime Sequence Quarter Id Quarter Number Quarter Sequence Field Goals Made Shot Type Three Point Shots |
| 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 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 Defensive Rebounds Defensive Rebounds Per Game Ejections 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 Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds Per Game 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 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: | Alias Id |
Market | Name |
| 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 |
| 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 Rotation Number 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 Rotation Number Home Team Seed Number Id Neutral Site Scheduled Date and Time Status Title |
| 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 |
| Opponent Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Ejections 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 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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points In The Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game Second Chance Points Second Chance Points Per Game 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 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 Defensive Rebounds Defensive Rebounds Per Game Ejections 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 Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds Per Game 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 Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
| Team Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Ejections 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 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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points In The Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game Second Chance Points Second Chance Points Per Game 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 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 |
| 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 Rotation Number 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 |
Home Team Rotation Number Home Team Seed Number Id Neutral Site Scheduled Date And Time Status Title |
| 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 |
| 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 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 |
| 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 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 Year Founded |
| Venue Data Points: | Address Capacity City |
Country Description Id |
Name State Zip |
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.
- 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.
- 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 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 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, 384 ], [ 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
- defensivethreeseconds
- delay
- ejection
- endperiod
- flagrantone
- flagranttwo
- freethrow
- jumpball
- kickball
- offensivefoul
- officialtimeout
- opentip
- personalfoul
- possession
- rebound
- review
- shootingfoul
- teamtimeout
- technicalfoul
- threepointmade
- threepointmiss
- turnover
- tvtimeout
- twopointmade
- twopointmiss
- warning
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.
Return to top
