get
https://api.sportradar.com/nba//v8//players//profile.
NBA Player Profile Provides player biographical information, draft information, and seasonal statistics.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Stats update around 5 minutes after a game moves to
closed
Accessing Player StatsLearn how to use Player Profile to access biographical information and career-spanning seasonal statistics for each player in our Seasonal Statistics (Player & Team) integration scenario.
Data Points
Draft Info
| 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 ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c |
year | draft | Integer | Draft year of a player |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | league | String | Alias of a league ex. NBA |
id | league | GUID | Unique ID of a league ex. 4353138d-4c22-4396-95d8-5f587d2df25c |
name | league | String | Name of a league ex. NBA |
id | season | GUID | Unique season ID ex. 583eca2f-fb46-11e1-82cb-f4ce4684ea4c |
type | season | String | Type of the seasonPRE (Preseason), REG (Regular Season), IST (In-Season Tournament), PIT (Play-In Tournament), PST (Postseason) |
year | season | Integer | Year of the season |
Player
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr_name | player | String | Abbreviated name of a player ex. S.Curry |
birth_date | player | Date | Player date of birth ex. 1995-09-17 |
birth_place | player | String | Birthplace of a player ex. Tyler, TX, USA |
college | player | String | College attended ex. Texas Tech |
experience | player | String | Number of years played in the NBA |
first_name | player | String | First name of a player ex. Stephen |
full_name | player | String | Full name of a player ex. Stephen Curry |
height | player | unsignedByte | Height in inches |
high_school | player | String | High school attended ex. Whitehouse (TX) |
id | player | GUID | Unique player ID 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 ex. Curry |
name_suffix | player | String | Suffix of a player ex. Jr. |
position | player | String | Position of a playerNA, C, C-F, F, F-C, F-G, G, G-F |
primary_position | player | String | Primary position of a playerNA, C, PF, PG, SF, SG |
reference | player | String | League reference ID of a player ex. 1626157 |
rookie_year | player | unsignedShort | Rookie year in the NBA |
salary | player | Integer | Current annual salary of a player ex. 2079935 |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:608110 |
status | player | String | Status of a playerACT (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 ex. 2022-09-30T22:55:57Z |
weight | player | unsignedShort | Weight in lbs. |
Player Reference
Use the
referencefield 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) - Totals
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
assists | statistics - total | Integer | Number of assists |
assists_turnover_ratio | statistics - total | Decimal | Assist to turnover ratio |
blocked_att | statistics - total | Integer | Number of blocked attempts |
blocks | statistics - total | Integer | Number of shots blocked |
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 |
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 |
ejections | statistics - total | Integer | Number of ejections |
fast_break_att | statistics - total | Integer | Number of fast break attempts |
fast_break_made | statistics - total | Integer | Number of fast break baskets |
fast_break_pct | statistics - total | Decimal | Fast break percentage ex. 100.0 |
fast_break_pts | statistics - total | Integer | Number of fast break points |
field_goals_att | statistics - total | Integer | Number of field goal attempts |
field_goals_made | statistics - total | Integer | Number of field goals made |
field_goals_pct | statistics - total | Decimal | Field goal percentage ex. 0.565 |
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. 0.565 |
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. 0.565 |
flagrant_fouls | statistics - total | Integer | Number of flagrant fouls |
foulouts | statistics - total | Integer | Number of foul outs |
fouls_drawn | statistics - total | Integer | Number of fouls drawn |
free_throws_att | statistics - total | Integer | Number of free throw attempts |
free_throws_made | statistics - total | Integer | Number of free throws made |
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 |
offensive_fouls | statistics - total | Integer | Number of offensive fouls |
offensive_rebounds | statistics - total | Integer | Number of offensive rebounds |
offensive_rebounds_pct | statistics - total | Decimal | Offensive rebound percentage ex. 20.0 |
personal_fouls | statistics - total | Integer | Number of personal fouls |
plus | statistics - total | Integer | Number of team points scored while a player is on the court |
points | statistics - total | Integer | Number of points |
points_in_paint | statistics - total | Integer | Number of points in the paint |
points_in_paint_att | statistics - total | Integer | Number of points in the paint attempts |
points_in_paint_made | statistics - total | Integer | Number of points in the paint baskets |
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 |
rebounds | statistics - total | Integer | Number of rebounds |
second_chance_att | statistics - total | Integer | Number of second chance attempts |
second_chance_made | statistics - total | Integer | Number of second chance baskets |
second_chance_pct | statistics - total | Decimal | Second chance percentage ex. 20.0 |
second_chance_pts | statistics - total | Integer | Number of second chance points |
steals | statistics - total | Integer | Number of steals |
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_made | statistics - total | Integer | Number of 3-point baskets |
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 |
true_shooting_pct | statistics - total | Decimal | True Shooting Percentage 100 * sPoints / (2 * sTrueShootingAttempts ) |
turnovers | statistics - total | Integer | Number of turnovers |
two_points_att | statistics - total | Integer | Number of 2-point attempts |
two_points_made | statistics - total | Integer | Number of 2-point baskets |
two_points_pct | statistics - total | Decimal | 2-point percentage ex. 100.0 |
usage_pct | statistics - total | Decimal | Usage Percentage ex. 27.61 |
Player Statistics (Season) - Averages
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
assists | statistics - average | Decimal | Assists per game |
blocked_att | statistics - average | Decimal | Blocked attempts per game |
blocks | statistics - average | Integer | Shots blocked per game |
def_rebounds | statistics - average | Decimal | Defensive rebounds per game |
efficiency | statistics - average | Decimal | Player Efficiency Rating per game |
fast_break_att | statistics - average | Decimal | Fast break attempts per game |
fast_break_made | statistics - average | Decimal | Fast break baskets per game |
fast_break_pct | statistics - average | Decimal | Fast break percentage per game ex. 82.0 |
fast_break_pts | statistics - average | Decimal | Fast break points per game |
field_goals_att | statistics - average | Decimal | Field goal attempts per game |
field_goals_made | statistics - average | Decimal | Field goals made per game |
flagrant_fouls | statistics - average | Decimal | Flagrant fouls per game |
fouls_drawn | statistics - average | Decimal | Fouls drawn per game |
free_throws_att | statistics - average | Decimal | Free throw attempts per game |
free_throws_made | statistics - average | Decimal | Free throws made per game |
minutes | statistics - average | Decimal | Minutes played per game |
offensive_fouls | statistics - average | Decimal | Offensive fouls per game |
off_rebounds | statistics - average | Decimal | Offensive rebounds per game |
personal_fouls | statistics - average | Decimal | Personal fouls per game |
points | statistics - average | Decimal | Points per game |
points_in_paint | statistics - average | Decimal | Points in the paint per game |
points_in_paint_att | statistics - average | Decimal | Points in the paint attempts per game |
points_in_paint_made | statistics - average | Decimal | Points in the paint baskets per game |
points_off_turnovers | statistics - average | Decimal | Points off turnovers per game |
rebounds | statistics - average | Decimal | Rebounds per game |
second_chance_att | statistics - average | Decimal | Second chance attempts per game |
second_chance_made | statistics - average | Decimal | Second chance baskets per game |
second_chance_pts | statistics - average | Decimal | Second chance points per game |
steals | statistics - average | Decimal | Steals per game |
three_points_att | statistics - average | Decimal | 3-point attempts per game |
three_points_made | statistics - average | Decimal | 3-point baskets per game |
true_shooting_att | statistics - average | Decimal | Number of attempts per game used to determine true shooting percentage |
turnovers | statistics - average | Decimal | Turnovers per game |
two_points_att | statistics - average | Decimal | 2-point attempts per game |
two_points_made | statistics - average | Decimal | 2-point baskets per game |
Team
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | team | String | Abbreviation of a team ex. SAC (Sacramento) |
id | team | GUID | Unique ID of a team ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | team | String | Market name of a team ex. Sacramento |
name | team | String | Team name ex. Kings |
reference | team | String | League reference ID of a team ex. 1610612750 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3415 |