Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Player Profile

NBA Player Profile Provides player biographical information, draft information, and seasonal statistics.

⏱️

Update Frequency

TTL / 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

AttributeParent ElementTypeDescription
id_typeplayer - referenceStringType 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)
scopeplayer - referenceStringName 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_idplayer - referenceGUIDUnique 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):
AttributeParent ElementTypeDescription
assistsstatistics - totalIntegerNumber of assists
assistsstatistics - averageDecimalAssists per game
assists_turnover_ratiostatistics - totalDecimalAssist to turnover ratio
blocked_attstatistics - totalIntegerNumber of blocked attempts
blocked_attstatistics - averageDecimalBlocked attempts per game
blocksstatistics - totalIntegerNumber of shots blocked
blocksstatistics - averageIntegerShots blocked per game
coach_ejectionsstatistics - totalIntegerNumber of coach ejections
coach_tech_foulsstatistics - totalIntegerNumber of coach technical fouls
defensive_reboundsstatistics - totalIntegerNumber of defensive rebounds
def_reboundsstatistics - averageDecimalDefensive rebounds per game
double_doublesstatistics - totalIntegerNumber of double-doubles
effective_fg_pctstatistics - totalDecimalEffective Field Goal Percentage
(FG + 0.5 * 3P) / FGA
efficiencystatistics - totalDecimalPlayer Efficiency Rating
(sPoints + sAssists + sBlocks + sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted-sFreeThrowsMade))
efficiencystatistics - averageDecimalPlayer Efficiency Rating per game
ejectionsstatistics - totalIntegerNumber of ejections
fast_break_attstatistics - totalIntegerNumber of fast break attempts
fast_break_attstatistics - averageDecimalFast break attempts per game
fast_break_madestatistics - totalIntegerNumber of fast break baskets
fast_break_madestatistics - averageDecimalFast break baskets per game
fast_break_pctstatistics - totalDecimalFast break percentage
ex. 100.0
fast_break_pctstatistics - averageDecimalFast break percentage per game
ex. 82.0
fast_break_ptsstatistics - totalIntegerNumber of fast break points
fast_break_ptsstatistics - averageDecimalFast break points per game
field_goals_attstatistics - totalIntegerNumber of field goal attempts
field_goals_attstatistics - averageDecimalField goal attempts per game
field_goals_madestatistics - totalIntegerNumber of field goals made
field_goals_madestatistics - averageDecimalField goals made per game
field_goals_pctstatistics - totalDecimalField goal percentage
ex. 56.5
field_goals_at_midrange_attstatistics - totalIntegerNumber of mid-range field goal attempts
field_goals_at_midrange_madestatistics - totalIntegerNumber of mid-range field goals made
field_goals_at_midrange_pctstatistics - totalDecimalMid-range field goal percentage
ex. 56.5
field_goals_at_rim_attstatistics - totalIntegerNumber of field goal attempts at the rim
field_goals_at_rim_madestatistics - totalIntegerNumber of field goals made at the rim
field_goals_at_rim_pctstatistics - totalDecimalAt the rim field goal percentage
ex. 56.5
flagrant_foulsstatistics - totalIntegerNumber of flagrant fouls
flagrant_foulsstatistics - averageDecimalFlagrant fouls per game
fouloutsstatistics - totalIntegerNumber of foul outs
fouls_drawnstatistics - totalIntegerNumber of fouls drawn
fouls_drawnstatistics - averageDecimalFouls drawn per game
free_throws_attstatistics - totalIntegerNumber of free throw attempts
free_throws_attstatistics - averageDecimalFree throw attempts per game
free_throws_madestatistics - totalIntegerNumber of free throws made
free_throws_madestatistics - averageDecimalFree throws made per game
free_throws_pctstatistics - totalDecimalFree throw percentage
ex. 100.0
games_playedstatistics - totalIntegerNumber of games played
games_startedstatistics - totalIntegerNumber of games started
minusstatistics - totalIntegerNumber of team points against while a player is on the court
minutesstatistics - totalStringNumber of minutes played
ex. 40:07
minutesstatistics - averageDecimalMinutes played per game
offensive_foulsstatistics - totalIntegerNumber of offensive fouls
offensive_foulsstatistics - averageDecimalOffensive fouls per game
offensive_reboundsstatistics - totalIntegerNumber of offensive rebounds
off_reboundsstatistics - averageDecimalOffensive rebounds per game
offensive_rebounds_pctstatistics - totalDecimalOffensive rebound percentage
ex. 20.0
personal_foulsstatistics - totalIntegerNumber of personal fouls
personal_foulsstatistics - averageDecimalPersonal fouls per game
plusstatistics - totalIntegerNumber of team points scored while a player is on the court
pointsstatistics - totalIntegerNumber of points
pointsstatistics - averageDecimalPoints per game
points_in_paintstatistics - totalIntegerNumber of points in the paint
points_in_paintstatistics - averageDecimalPoints in the paint per game
points_in_paint_attstatistics - totalIntegerNumber of points in the paint attempts
points_in_paint_attstatistics - averageDecimalPoints in the paint attempts per game
points_in_paint_madestatistics - totalIntegerNumber of points in the paint baskets
points_in_paint_madestatistics - averageDecimalPoints in the paint baskets per game
points_in_paint_pctstatistics - totalDecimalPoints in the paint percentage
ex. 28.6
points_off_turnoversstatistics - totalIntegerNumber of points off turnovers
points_off_turnoversstatistics - averageDecimalPoints off turnovers per game
reboundsstatistics - totalIntegerNumber of rebounds
reboundsstatistics - averageDecimalRebounds per game
second_chance_attstatistics - totalIntegerNumber of second chance attempts
second_chance_attstatistics - averageDecimalSecond chance attempts per game
second_chance_madestatistics - totalIntegerNumber of second chance baskets
second_chance_madestatistics - averageDecimalSecond chance baskets per game
second_chance_pctstatistics - totalDecimalSecond chance percentage
ex. 20.0
second_chance_ptsstatistics - totalIntegerNumber of second chance points
second_chance_ptsstatistics - averageDecimalSecond chance points per game
stealsstatistics - totalIntegerNumber of steals
stealsstatistics - averageDecimalSteals per game
tech_foulsstatistics - totalIntegerNumber of total unsportsmanlike technical fouls
tech_fouls_non _unsportsmanlikestatistics - totalIntegerNumber of non-unsportsmanlike technical fouls
three_points_attstatistics - totalIntegerNumber of 3-point attempts
three_points_attstatistics - averageDecimal3-point attempts per game
three_points_madestatistics - totalIntegerNumber of 3-point baskets
three_points_madestatistics - averageDecimal3-point baskets per game
three_points_pctstatistics - totalDecimal3-point percentage
ex. 100.0
triple_doublestatistics - totalIntegerNumber of triple-doubles
true_shooting_attstatistics - totalDecimalNumber of attempts used to determine true shooting percentage
sFieldGoalsAttempted + (0.44 * sFreeThrowsAttempted)
true_shooting_attstatistics - averageDecimalNumber of attempts per game used to determine true shooting percentage
true_shooting_pctstatistics - totalDecimalTrue Shooting Percentage
100 * sPoints / (2 * sTrueShootingAttempts )
turnoversstatistics - totalIntegerNumber of turnovers
turnoversstatistics - averageDecimalTurnovers per game
two_points_attstatistics - totalIntegerNumber of 2-point attempts
two_points_attstatistics - averageDecimal2-point attempts per game
two_points_madestatistics - totalIntegerNumber of 2-point baskets
two_points_madestatistics - averageDecimal2-point baskets per game
two_points_pctstatistics - totalDecimal2-point percentage
ex. 100.0
usage_pctstatistics - totalDecimalUsage 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>


Language
Credentials
Header
Click Try It! to start a request and see the response here!