NBA Player Profile Provides player biographical information, draft information, and seasonal statistics.
Update FrequencyTTL / Cache: 2 Seconds
Data Updates: Stats are updated around 5 minutes after a game is moved to
closed
Data Points
<Accordion title="Draft Info:" icon="fa-info-circle"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `pick` | `draft` | Integer | Draft pick number of a player | | `round` | `draft` | Integer | Draft pick round of a player | | `team_id` | `draft` | Integer | Unique ID of a draft team<br />ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c` | | `year` | `draft` | Integer | Draft year of a player | </Accordion>
<Accordion title="League:" icon="fa-info-circle"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `alias` | `league` | String | Alias of a league<br />ex. `NBA` | | `id` | `league` | GUID | Unique ID of a league<br />ex. `4353138d-4c22-4396-95d8-5f587d2df25c` | | `name` | `league` | String | Name of a league<br />ex. `NBA` | | `id` | `season` | GUID | Unique season ID<br />ex. `583eca2f-fb46-11e1-82cb-f4ce4684ea4c` | | `type` | `season` | String | Type of the season<br />`PRE` (Preseason), `REG` (Regular Season), `IST` (In-Season Tournament), `PIT` (Play-In Tournament), `PST` (Postseason) | | `year` | `season` | Integer | Year of the season | </Accordion>
<Accordion title="Player:" icon="fa-info-circle"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `abbr_name` | `player` | String | Abbreviated name of a player<br />ex. `S.Curry` | | `birth_date` | `player` | Date | Player date of birth<br />ex. `1995-09-17` | | `birth_place` | `player` | String | Birthplace of a player<br />ex. `Tyler, TX, USA` | | `college` | `player` | String | College attended<br />ex. `Texas Tech` | | `experience` | `player` | String | Number of years played in the NBA | | `first_name` | `player` | String | First name of a player<br />ex. `Stephen` | | `full_name` | `player` | String | Full name of a player<br />ex. `Stephen Curry` | | `height` | `player` | unsignedByte | Height in inches | | `high_school` | `player` | String | High school attended<br />ex. `Whitehouse (TX)` | | `id` | `player` | GUID | Unique player ID<br />ex. `8ec91366-faea-4196-bbfd-b8fab7434795` | | `jersey_number` | `player` | Integer | Number of a player's jersey | | `last_name` | `player` | String | Last name of a player<br />ex. `Curry` | | `name_suffix` | `player` | String | Suffix of a player<br />ex. `Jr.` | | `position` | `player` | String | Position of a player<br />`NA`, `C`, `C-F`, `F`, `F-C`, `F-G`, `G`, `G-F` | | `primary_position` | `player` | String | Primary position of a player<br />`NA`, `C`, `PF`, `PG`, `SF`, `SG` | | `reference` | `player` | String | League reference ID of a player<br />ex. `1626157` | | `rookie_year` | `player` | unsignedShort | Rookie year in the NBA | | `salary` | `player` | Integer | Current annual salary of a player<br />ex. `2079935` | | `sr_id` | `player` | GUID | Unique Sportradar ID of a player<br />ex. `sr:player:608110` | | `status` | `player` | String | Status of a player<br />`ACT` (Active), `SUS` (Suspended), `IR` (Injured Reserve), `TWO-WAY` (Two-Way Contract / D-League), `NWT` (Not with Team), `FA` (Free Agent), `RET` (Retired), `DUP` (Duplicate), `M-LEAGUE` (Sent to minor league team), `TEN-DAY` (10-day Contract) | | `updated` | `player` | dateTime | Timestamp of a change to a player profile<br />ex. `2022-09-30T22:55:57Z` | | `weight` | `player` | unsignedShort | Weight in lbs. | </Accordion>
<Accordion title="Player Reference:" icon="fa-info-circle"> > Use the `reference` field to link a player's NBA API profile to their NCAA Men's Basketball API or NBA G League API profile
| Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `id_type` | `player` - `reference` | String | Type of a player's linked player Id<br /><br />ex. `league_profile` (League Player Id), `external` (NBA official `reference` Id), `sport_profile` (League-Specific API Id, synched across NBA, NCAAMB, and G League APIs) | | `scope` | `player` - `reference` | String | Name of the league/API for a player's linked Id<br><br />ex. `NCAAMB` (NCAA Men's Basketball API), `NBDL` (NBA G League API), `NBA` (NBA official `reference` Id), `basketball` (Player "parent" Id entry for League-Specific Sport APIs) | | `source_id` | `player` - `reference` | GUID | Unique player Id for a linked player profile<br /><br />ex. `531fa6d3-9c8e-437b-8eca-8ca79bf12cc0` (Player Id within the NCAA Men's Basketball API or G League API), `1630545` (NBA official `reference` Id) | </Accordion>
Player Reference:
Use the
reference
field to link a player's NBA API profile to their NCAA Men's Basketball API or NBA G League API profile
Attribute | Parent Element | Type | Description |
---|---|---|---|
id_type | player - reference | String | Type of a player's linked player Id ex. league_profile (League Player Id), external (NBA official reference Id), sport_profile (League-Specific API Id, synched across NBA, NCAAMB, and G League APIs) |
scope | player - reference | String | Name of the league/API for a player's linked Id ex. NCAAMB (NCAA Men's Basketball API), NBDL (NBA G League API), NBA (NBA official reference Id), basketball (Player "parent" Id entry for League-Specific Sport APIs) |
source_id | player - reference | GUID | Unique player Id for a linked player profile ex. 531fa6d3-9c8e-437b-8eca-8ca79bf12cc0 (Player Id within the NCAA Men's Basketball API or G League API), 1630545 (NBA official reference Id) |
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 (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 | Integer | Number of triple-doubles |
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 |
usage_pct | statistics - total | Decimal | Usage Percentage: an estimate of the percentage of team plays used by a player while they are on the floor ex. 27.61 |
<Accordion title="Team:" icon="fa-info-circle"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `alias` | `team` | String | Abbreviation of a team<br />ex. `SAC` (Sacramento) | | `id` | `team` | GUID | Unique ID of a team<br />ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c` | | `market` | `team` | String | Market name of a team<br />ex. `Sacramento` | | `name` | `team` | String | Team name<br />ex. `Kings` | | `reference` | `team` | String | League reference ID of a team<br />ex. `1610612750` | | `sr_id` | `team` | GUID | Unique Sportradar ID of a team<br />ex. `sr:team:3415` | </Accordion>