League Hierarchy

⏱️
Update Frequency
TTL / Cache: 300 seconds
Data Updates: As Necessary

⏱️
Update Frequency
TTL / Cache: 120 seconds
Data Updates: As Necessary

Data Points

Season:

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique season ID ex. `825bcfa1-45a6-4d71-91d9-c9f46ec11a0e`
`type`	`season`	String	Type of the season `PRE` (Preseason), `REG` (Regular Season), `CC` (Commissioner's Cup), `PST` (Postseason)
`year`	`season`	Integer	Year of the season

Leader Categories and Rankings:

This feed provides total season leaders and per game leaders.

Total Season Categories: Minutes, Points, Assists, Turnovers, Steals, Blocks, Blocked Attempts, Field Goals Made, Field Goal Attempts, 3-Pointers Made, 3-Point Attempts, 2-Pointers Made, 2-Point Attempts, Free Throws Made, Free Throw Attempts, Offensive Rebounds, Defensive Rebounds, Rebounds, Personal Fouls, Technical Fouls, Foul Outs, Field Goal Percentage, 2-Point Percentage, 3-Point Percentage, Free Throw Percentage

Per Game Categories: Minutes, Points, Offensive Rebounds, Defensive Rebounds, Rebounds, Assists, Steals, Blocks, Turnovers, Blocked Attempts, Personal Fouls, Field Goals Made, Field Goal Attempts, 3-Pointers Made, 3-Point Attempts, 2-Pointers Made, 2-Point Attempts, Free Throws Made, Free Throw Attempts

Attribute	Parent Element	Type	Description
`alias`	`leaders`	String	Alias of a leader grouping ex. `WNBA`
`id`	`leaders`	GUID	Unique ID of a leader grouping ex. `59c24590-0adb-4b3d-80a8-10450f83f4a1`
`name`	`leaders`	String	Name of a leader grouping ex. `WNBA`
`type`	`leaders`	String	Type of a leader grouping ex. `league`
`name`	`category`	String	Name of a leader category ex. `minutes`
`type`	`category`	String	Type of a leader category. Categories will be separated into total season leaders and per game leaders. For example, Total Points Leaders and Points Per Game Leaders `total`, `average`
`rank`	`rank`	Integer	Player rank for a statistic (1-25)
`score`	`rank`	Decimal	Player's total for a statistic ex. `309.0` under category name of `minutes` and category type of `total` equals 309 total minutes played
`tied`	`rank`	Boolean	Signifies a player is tied in the rankings for a statistic

Player:

Attribute	Parent Element	Type	Description
`first_name`	`player`	String	First name of a player ex. `Jennie`
`full_name`	`player`	String	Full name of a player ex. `Jennie Simms`
`jersey_number`	`player`	Integer	Number of a player's jersey
`id`	`player`	GUID	Unique ID of a player ex. `fb74e168-9e07-4656-ac2c-14fb8a8e35bd`
`last_name`	`player`	String	Last name of a player ex. `Simms`
`position`	`player`	String	Position of a player `NA`, `C`, `C-F`, `F`, `F-C`, `F-G`, `G`, `G-F`
`primary_position`	`player`	String	Primary position of a player `NA`, `C`, `PF`, `PG`, `SF`, `SG`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:1157062`

Player Statistics (Season):

Attribute	Parent Element	Type	Description
`assists`	`statistics` - `total`	Integer	Number of assists
`assists`	`statistics` - `average`	Decimal	Assists per game
`assists_turnover_ratio`	`statistics` - `total`	Decimal	Assist to turnover ratio
`blocked_att`	`statistics` - `total`	Integer	Number of blocked attempts
`blocked_att`	`statistics` - `average`	Decimal	Blocked attempts per game
`blocks`	`statistics` - `total`	Integer	Number of shots blocked
`blocks`	`statistics` - `average`	Integer	Shots blocked per game
`coach_ejections`	`statistics` - `total`	Integer	Number of coach ejections
`coach_tech_fouls`	`statistics` - `total`	Integer	Number of coach technical fouls
`defensive_rebounds`	`statistics` - `total`	Integer	Number of defensive rebounds
`def_rebounds`	`statistics` - `average`	Decimal	Defensive rebounds per game
`double_doubles`	`statistics` - `total`	Integer	Number of double-doubles
`effective_fg_pct`	`statistics` - `total`	Decimal	Effective Field Goal Percentage (FG + 0.5 3P) / FGA*
`efficiency`	`statistics` - `total`	Decimal	Player Efficiency Rating (sPlayer Efficiency Rating (sPoints + sAssists + sBlocks+sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted - sFreeThrowsMade))
`efficiency`	`statistics` - `average`	Decimal	Player Efficiency Rating per game
`ejections`	`statistics` - `total`	Integer	Number of ejections
`fast_break_att`	`statistics` - `total`	Integer	Number of fast break attempts
`fast_break_att`	`statistics` - `average`	Decimal	Fast break attempts per game
`fast_break_made`	`statistics` - `total`	Integer	Number of fast break baskets
`fast_break_made`	`statistics` - `average`	Decimal	Fast break baskets per game
`fast_break_pct`	`statistics` - `total`	Decimal	Fast break percentage ex. `100.0`
`fast_break_pct`	`statistics` - `average`	Decimal	Fast break percentage per game ex. `82.0`
`fast_break_pts`	`statistics` - `total`	Integer	Number of fast break points
`fast_break_pts`	`statistics` - `average`	Decimal	Fast break points per game
`field_goals_att`	`statistics` - `total`	Integer	Number of field goal attempts
`field_goals_att`	`statistics` - `average`	Decimal	Field goal attempts per game
`field_goals_made`	`statistics` - `total`	Integer	Number of field goals made
`field_goals_made`	`statistics` - `average`	Decimal	Field goals made per game
`field_goals_pct`	`statistics` - `total`	Decimal	Field goal percentage ex. `56.5`
`field_goals_at_midrange_att`	`statistics` - `total`	Integer	Number of mid-range field goal attempts
`field_goals_at_midrange_made`	`statistics` - `total`	Integer	Number of mid-range field goals made
`field_goals_at_midrange_pct`	`statistics` - `total`	Decimal	Mid-range field goal percentage ex. `56.5`
`field_goals_at_rim_att`	`statistics` - `total`	Integer	Number of field goal attempts at the rim
`field_goals_at_rim_made`	`statistics` - `total`	Integer	Number of field goals made at the rim
`field_goals_at_rim_pct`	`statistics` - `total`	Decimal	At the rim field goal percentage ex. `56.5`
`flagrant_fouls`	`statistics` - `total`	Integer	Number of flagrant fouls
`flagrant_fouls`	`statistics` - `average`	Decimal	Flagrant fouls per game
`foulouts`	`statistics` - `total`	Integer	Number of foul outs
`fouls_drawn`	`statistics` - `total`	Integer	Number of fouls drawn
`fouls_drawn`	`statistics` - `average`	Decimal	Fouls drawn per game
`free_throws_att`	`statistics` - `total`	Integer	Number of free throw attempts
`free_throws_att`	`statistics` - `average`	Decimal	Free throw attempts per game
`free_throws_made`	`statistics` - `total`	Integer	Number of free throws made
`free_throws_made`	`statistics` - `average`	Decimal	Free throws made per game
`free_throws_pct`	`statistics` - `total`	Decimal	Free throw percentage ex. `100.0`
`games_played`	`statistics` - `total`	Integer	Number of games played
`games_started`	`statistics` - `total`	Integer	Number of games started
`minus`	`statistics` - `total`	Integer	Number of team points against while a player is on the court
`minutes`	`statistics` - `total`	String	Number of minutes played ex. `40:07`
`minutes`	`statistics` - `average`	Decimal	Minutes played per game
`offensive_fouls`	`statistics` - `total`	Integer	Number of offensive fouls
`offensive_fouls`	`statistics` - `average`	Decimal	Offensive fouls per game
`offensive_rebounds`	`statistics` - `total`	Integer	Number of offensive rebounds
`off_rebounds`	`statistics` - `average`	Decimal	Offensive rebounds per game
`offensive_rebounds_pct`	`statistics` - `total`	Decimal	Offensive rebound percentage ex. `20.0`
`personal_fouls`	`statistics` - `total`	Integer	Number of personal fouls
`personal_fouls`	`statistics` - `average`	Decimal	Personal fouls per game
`plus`	`statistics` - `total`	Integer	Number of team points scored while a player is on the court
`points`	`statistics` - `total`	Integer	Number of points
`points`	`statistics` - `average`	Decimal	Points per game
`points_in_paint`	`statistics` - `total`	Integer	Number of points in the paint
`points_in_paint`	`statistics` - `average`	Decimal	Points in the paint per game
`points_in_paint_att`	`statistics` - `total`	Integer	Number of points in the paint attempts
`points_in_paint_att`	`statistics` - `average`	Decimal	Points in the paint attempts per game
`points_in_paint_made`	`statistics` - `total`	Integer	Number of points in the paint baskets
`points_in_paint_made`	`statistics` - `average`	Decimal	Points in the paint baskets per game
`points_in_paint_pct`	`statistics` - `total`	Decimal	Points in the paint percentage ex. `28.6`
`points_off_turnovers`	`statistics` - `total`	Integer	Number of points off turnovers
`points_off_turnovers`	`statistics` - `average`	Decimal	Points off turnovers per game
`rebounds`	`statistics` - `total`	Integer	Number of rebounds
`rebounds`	`statistics` - `average`	Decimal	Rebounds per game
`second_chance_att`	`statistics` - `total`	Integer	Number of second chance attempts
`second_chance_att`	`statistics` - `average`	Decimal	Second chance attempts per game
`second_chance_made`	`statistics` - `total`	Integer	Number of second chance baskets
`second_chance_made`	`statistics` - `average`	Decimal	Second chance baskets per game
`second_chance_pct`	`statistics` - `total`	Decimal	Second chance percentage ex. `20.0`
`second_chance_pts`	`statistics` - `total`	Integer	Number of second chance points
`second_chance_pts`	`statistics` - `average`	Decimal	Second chance points per game
`steals`	`statistics` - `total`	Integer	Number of steals
`steals`	`statistics` - `average`	Decimal	Steals per game
`tech_fouls`	`statistics` - `total`	Integer	Number of total unsportsmanlike technical fouls
`tech_fouls_non _unsportsmanlike`	`statistics` - `total`	Integer	Number of non-unsportsmanlike technical fouls
`three_points_att`	`statistics` - `total`	Integer	Number of 3-point attempts
`three_points_att`	`statistics` - `average`	Decimal	3-point attempts per game
`three_points_made`	`statistics` - `total`	Integer	Number of 3-point baskets
`three_points_made`	`statistics` - `average`	Decimal	3-point baskets per game
`three_points_pct`	`statistics` - `total`	Decimal	3-point percentage ex. `100.0`
`triple_double`	`statistics` - `total`	Boolean	Signifies a triple-double
`true_shooting_att`	`statistics` - `total`	Decimal	Number of attempts used to determine true shooting percentage sFieldGoalsAttempted + (0.44 * sFreeThrowsAttempted)
`true_shooting_att`	`statistics` - `average`	Decimal	Number of attempts per game used to determine true shooting percentage
`true_shooting_pct`	`statistics` - `total`	Decimal	True Shooting Percentage 100 sPoints / (2 sTrueShootingAttempts )
`turnovers`	`statistics` - `total`	Integer	Number of turnovers
`turnovers`	`statistics` - `average`	Decimal	Turnovers per game
`two_points_att`	`statistics` - `total`	Integer	Number of 2-point attempts
`two_points_att`	`statistics` - `average`	Decimal	2-point attempts per game
`two_points_made`	`statistics` - `total`	Integer	Number of 2-point baskets
`two_points_made`	`statistics` - `average`	Decimal	2-point baskets per game
`two_points_pct`	`statistics` - `total`	Decimal	2-point percentage ex. `100.0`

Team:

Attribute	Parent Element	Type	Description
`id`	`team`	GUID	Unique ID of a team ex. `08ed8274-e29f-4248-bc2e-83cc8ed18d75`
`market`	`team`	String	Market name of a team ex. `New York`
`name`	`team`	String	Team name ex. `Liberty`
`sr_id`	`team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3446`

Data Points

League:

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `WNBA`
`id`	`league`	GUID	Unique ID of a league ex. `59c24590-0adb-4b3d-80a8-10450f83f4a1`
`name`	`league`	String	Name of a league ex. `WNBA`
`alias`	`conference`	String	Alias of a conference ex. `EASTERN-W`
`id`	`conference`	GUID	Unique ID of a conference ex. `092510cf-3285-48bb-b831-40ac3608ca36`
`name`	`conference`	String	Name of a conference ex. `EASTERN CONFERENCE`

Team:

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `NYL` (New York Liberty)
`championship_seasons`	`team`	String	Years of championship seasons ex. `2011, 2013, 2015, 2017`
`championships_won`	`team`	Integer	Number of championships won
`conference_titles`	`team`	Integer	Number of conference titles
`founded`	`team`	Integer	Year team was founded ex. `1999`
`franchise_id`	`team`	GUID	Unique ID of a franchise. This Id will remain constant should a team change its host city. ex. `8675491c-69a6-4097-bb00-46636be26670`
`general_manager`	`team`	String	Team general manager ex. `Clare Duwelius`
`id`	`team`	GUID	Unique ID of a team ex. `08ed8274-e29f-4248-bc2e-83cc8ed18d75`
`market`	`team`	String	Market name of a team ex. `New York`
`mascot`	`team`	String	Team mascot ex. `Prowl`
`name`	`team`	String	Team name ex. `Liberty`
`nicknames`	`team`	String	Team nicknames
`owner`	`team`	String	Team owner ex. `Glen Taylor, Alex Rodriguez, and Marc Lore`
`playoff_appearances`	`team`	Integer	Number of playoff appearances
`president`	`team`	String	Team president ex. `Carley Knox`
`retired_numbers`	`team`	String	Team retired jersey numbers ex. `13, 32, 33, 34`
`sponsor`	`team`	String	Team sponsor ex. `Mayo Clinic`
`sr_id`	`team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3446`
`hex_color`	`team_color`	String	Team color HEX value ex. `#0c233f`
`type`	`team_color`	String	Type of team color `primary`, `secondary`
`red`	`team_color` - `rgb-color`	Integer	Team RGB color code - Red ex. `12`
`green`	`team_color` - `rgb-color`	Integer	Team RGB color code - Green ex. `35`
`blue`	`team_color` - `rgb-color`	Integer	Team RGB color code - Blue ex. `63`

Venue:

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `600 First Avenue North`
`capacity`	`venue`	String	Capacity of a venue ex. `19356`
`city`	`venue`	String	City of a venue ex. `Minneapolis`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `7aed802e-3562-5b73-af1b-3859529f9b95`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `44.979444`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-93.276111`
`name`	`venue`	String	Name of a venue ex. `Golden 1 Center`
`sr_id`	`venue`	GUID	Unique Sportradar ID of a venue ex. `sr:venue:6930`
`state`	`venue`	String	State or province of a venue ex. `MN`
`zip`	`venue`	Integer	ZIP code of a venue ex. `55403`