Player Profile

⏱️
Update Frequency
TTL / Cache: 120 seconds
Data Updates: Seasonal stats are updated around 5 minutes after a game is moved to closed

Data Points

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NCAAM`
`id`	`league`	GUID	Unique ID of a league ex. `cd4268ee-07aa-4c4d-a435-ec44ad2c76cb`
`name`	`league`	String	Name of a league ex. `NCAA MEN`
`id`	`season`	GUID	Unique ID of a season ex. `415ae0cb-38dd-4ace-8f22-fb6015b39006`
`type`	`season`	String	Type of a season `REG` (Regular Season)
`year`	`season`	Integer	Year of a season

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `N.Cummings`
`birth_place`	`player`	String	Birthplace of a player ex. `Midland, PA, USA`
`experience`	`player`	String	Year in school `FR`(Freshman), `SO`(Sophomore), `JR`(Junior), `SR`(Senior), `GR`(Graduate Student)
`first_name`	`player`	String	First name of a player ex. `Nelly`
`full_name`	`player`	String	Full name of a player ex. `Nelly Cummings`
`height`	`player`	unsignedByte	Height in inches
`id`	`player`	GUID	Unique player ID ex. `82643a21-c4ec-4725-b729-f4c65727c93d`
`jersey_number`	`player`	Integer	Number of a player's jersey
`last_name`	`player`	String	Last name of a player ex. `Cummings`
`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`
`status`	`player`	String	Status of a player `ACT` (Active), `NWT` (Not with Team), `SUS`(Suspended), `DUP` (Duplicate player profile)
`updated`	`player`	dateTime	Timestamp of a change to a free agent status ex. `2022-09-30T22:55:57Z`
`weight`	`player`	unsignedShort	Weight in lbs.

Player Reference

Use the reference field to link a player's NCAA API profile to their NBA or G League API profile, if applicable

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
`defensive_rebounds`	`statistics` - `total`	Integer	Number of defensive rebounds
`def_rebounds`	`statistics` - `average`	Decimal	Defensive rebounds per game
`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
`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
`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
`minutes`	`statistics` - `total`	String	Number of minutes played ex. `40:07`
`minutes`	`statistics` - `average`	Decimal	Minutes played per game
`offensive_rebounds`	`statistics` - `total`	Integer	Number of offensive rebounds
`off_rebounds`	`statistics` - `average`	Decimal	Offensive rebounds per game
`personal_fouls`	`statistics` - `total`	Integer	Number of personal fouls
`personal_fouls`	`statistics` - `average`	Decimal	Personal fouls per game
`points`	`statistics` - `total`	Integer	Number of points
`points`	`statistics` - `average`	Decimal	Points per game
`rebounds`	`statistics` - `total`	Integer	Number of rebounds
`rebounds`	`statistics` - `average`	Decimal	Rebounds per game
`steals`	`statistics` - `total`	Integer	Number of steals
`steals`	`statistics` - `average`	Decimal	Steals per game
`tech_fouls`	`statistics` - `total`	Integer	Number of 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`
`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`

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `PITT`
`id`	`team`	GUID	Unique ID of a team ex. `24051034-96bb-4f78-a3a6-312f3258780f`
`market`	`team`	String	School name of a team ex. `Pittsburgh`
`name`	`team`	String	Team name ex. `Panthers`