SportsDataIO · Schema
PlayerDetail
Sports DataStatisticsLive ScoresFantasy SportsOddsNFLNBAMLBNHLSoccer
Properties
| Name | Type | Description |
|---|---|---|
| PlayerSeason | object | This field is expected to be NULL |
| LatestNews | array | The latest news associated with this player |
| PlayerID | integer | The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career. |
| Team | stringnull | The abbreviation [Key] of the team that the player is on. Note: If this player is a free agent; this field is NULL. |
| Number | integernull | Player's jersey number |
| FirstName | stringnull | Player's first name |
| LastName | stringnull | Player's last name |
| Position | stringnull | The primary position of the player. Possible Values: C; CB; DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB; RB; S; SS; T; TE; WR. |
| Status | stringnull | The player's current status. Possible values include Active, Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad, Suspended, Non Football Injury, Non-Football Illness, Commissioner |
| Height | stringnull | Height in feet, inches |
| Weight | integernull | Player's weight in pounds |
| BirthDate | stringnull | Player's date of birth |
| College | stringnull | College team the player played for prior to turning professional |
| Experience | integernull | Number of years experience. Note: This number is incremented every year; in the Spring; when we load the rookies following the NFL Draft. Rookies will have Experience = 0; while second year players wi |
| FantasyPosition | stringnull | The player's fantasy football position. Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL. |
| Active | booleannull | Whether or not the player is on the active roster of the NFL team (True/False) |
| PositionCategory | stringnull | The category of the player's position (OFF; DEF; ST) |
| Name | stringnull | Player's full name |
| Age | integernull | The player's current age |
| ExperienceString | stringnull | The player's experience converted to a string |
| BirthDateString | stringnull | The player's date of birth converted to a string |
| PhotoUrl | stringnull | This field is deprecated. Note: Headshots are now delivered through IMAGN. Please see our Headshots products for further information. |
| ByeWeek | integernull | The week the player is on bye for the upcoming or current season |
| UpcomingGameOpponent | stringnull | The opposing team the player is playing against in the upcoming week |
| UpcomingGameWeek | integer | The week of the player's upcoming game (this will be the upcoming week unless the player is on Bye that week, which would bump it to the next week) |
| ShortName | stringnull | The first initial and last name of the player (J. Doe) |
| AverageDraftPosition | numbernull | The average draft position of the player in re-draft leagues |
| DepthPositionCategory | stringnull | The category (Offense, Defense or Special Teams) of the players DepthPositionCategory (OFF, DEF, ST) |
| DepthPosition | stringnull | The position this player is listed at on his team's depth chart (e.g. QB; LWR; RDE; LILB, K) |
| DepthOrder | integernull | The order this player is at his position (1 = Starter; 2 = Backup; 3 = 3rd String; 4 = 4th String; 5 = 5th String) |
| DepthDisplayOrder | integernull | The display order of the positions (for display purposes) |
| CurrentTeam | stringnull | The team who currently employs this player. This value is null when this player is unemployed (for example a free agent or retired player). |
| CollegeDraftTeam | stringnull | The team who drafted this player. Note: If this player was an Undrafted Free Agent; then it's the team who first signed him as a rookie. |
| CollegeDraftYear | integernull | The year this player entered the NFL as a rookie |
| CollegeDraftRound | integernull | The round this player was drafted in |
| CollegeDraftPick | integernull | The overall pick in the draft this player was selected |
| IsUndraftedFreeAgent | boolean | Whether this player was an undrafted free agent. This value is True if the player was not drafted. |
| HeightFeet | integernull | The feet component of a player's height (if player is 6'3", then this value would be 6) |
| HeightInches | integernull | The inches component of a player's height (if player is 6'3", then this value would be 3) |
| UpcomingOpponentRank | integernull | The player's upcoming opponent's rank in fantasy points allowed |
| UpcomingOpponentPositionRank | integernull | The player's upcoming opponent's rank in fantasy points allowed to his fantasy position |
| CurrentStatus | stringnull | The player's current status. Possible values include Active, Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad, Suspended, Non Football Injury, Non-Football Illness, Commissioner |
| UpcomingSalary | integernull | The player's salary for the upcoming week in accordance with a $50,000 salary cap. This is used for daily fantasy sports salary cap contests. Salaries represent those published by DraftKings. When Dra |
| FantasyAlarmPlayerID | integernull | The player's cross reference PlayerID to the FantasyAlarm news feed |
| SportRadarPlayerID | stringnull | The player's cross reference PlayerID to the SportRadar API |
| RotoworldPlayerID | integernull | The player's cross reference PlayerID to the Rotoworld news feed |
| RotoWirePlayerID | integernull | The player's cross reference PlayerID to the RotoWire news feed |
| StatsPlayerID | integernull | The player's cross reference PlayerID to the STATS data feeds |
| SportsDirectPlayerID | integernull | The player's cross reference PlayerID to the SportsDirect data feeds, now part of Nielsen GraceNote |
| XmlTeamPlayerID | integernull | The player's unique PlayerID for cross reference use with XML Team data feeds |
| FanDuelPlayerID | integernull | The player's cross reference PlayerID to FanDuel |
| DraftKingsPlayerID | integernull | The player's cross reference PlayerID to DraftKings |
| YahooPlayerID | integernull | The player's unique PlayerID for cross reference use with Yahoo |
| InjuryStatus | stringnull | The player's current injury status, in the form of likelihood that player plays (Probable, Questionable, Doubtful, Out) |
| InjuryBodyPart | stringnull | The body part that is injured for the player (Knee; Groin; Calf; Hamstring; etc.) |
| InjuryStartDate | stringnull | The day that the player's injury started or was first discovered |
| InjuryNotes | stringnull | A brief description of the player's injury and expected availability |
| FanDuelName | stringnull | The player's full name in FanDuel's daily fantasy sports platform |
| DraftKingsName | stringnull | The player's full name in DraftKings' daily fantasy sports platform |
| YahooName | stringnull | The player's name in Yahoo's daily fantasy sports platform |
| FantasyPositionDepthOrder | integernull | The order this player is at his team's FantasyPosition |
| InjuryPractice | stringnull | This field is deprecated |
| InjuryPracticeDescription | stringnull | This field is deprecated |
| DeclaredInactive | boolean | Whether the player has been declared inactive. This value is updated in the hours leading up to game start time; as teams announce their inactive players. Note: This is only updated for offensive skil |
| UpcomingFanDuelSalary | integernull | The player's FanDuel salary for the upcoming week. Note: We recommend using our new DFS endpoints instead. |
| UpcomingDraftKingsSalary | integernull | The player's DraftKings salary for the upcoming week. Note: We recommend using our new DFS endpoints instead. |
| UpcomingYahooSalary | integernull | The player's Yahoo salary for the upcoming week. We recommend using our new DFS endpoints instead. |
| TeamID | integernull | The unique ID of the team that the player is on. Note: If the player is a free agent; this field is NULL |
| GlobalTeamID | integernull | A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues. |
| FantasyDraftPlayerID | integernull | The player's cross reference PlayerID to FantasyDraft |
| FantasyDraftName | stringnull | The player's full name in FantasyDraft's daily fantasy sports platform |
| UsaTodayPlayerID | integernull | The player's cross reference PlayerID to USA Today headshot data feeds |
| UsaTodayHeadshotUrl | stringnull | The player's headshot URL as provided by USA Today. License from USA Today is required. |
| UsaTodayHeadshotNoBackgroundUrl | stringnull | The player's transparent background headshot URL as provided by USA Today. License from USA Today is required. |
| UsaTodayHeadshotUpdated | stringnull | The last updated date of the player's headshot as provided by USA Today. License from USA Today is required. |
| UsaTodayHeadshotNoBackgroundUpdated | stringnull | The last updated date of the player's transparent background headshot as provided by USA Today. License from USA Today is required. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/PlayerDetail",
"title": "PlayerDetail",
"properties": {
"PlayerSeason": {
"$ref": "#/components/schemas/PlayerSeason",
"description": "This field is expected to be NULL"
},
"LatestNews": {
"type": "array",
"items": {
"$ref": "#/components/schemas/News"
},
"description": "The latest news associated with this player"
},
"PlayerID": {
"type": "integer",
"description": "The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career."
},
"Team": {
"type": [
"string",
"null"
],
"description": "The abbreviation [Key] of the team that the player is on. Note: If this player is a free agent; this field is NULL."
},
"Number": {
"type": [
"integer",
"null"
],
"description": "Player's jersey number"
},
"FirstName": {
"type": [
"string",
"null"
],
"description": "Player's first name"
},
"LastName": {
"type": [
"string",
"null"
],
"description": "Player's last name"
},
"Position": {
"type": [
"string",
"null"
],
"description": "The primary position of the player. Possible Values: C; CB; DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB; RB; S; SS; T; TE; WR."
},
"Status": {
"type": [
"string",
"null"
],
"description": "The player's current status. Possible values include Active, Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad, Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and Voluntary Opt Out. Inactive indicates that this player is a free agent. Active indicates that this player is on his team's active roster."
},
"Height": {
"type": [
"string",
"null"
],
"description": "Height in feet, inches"
},
"Weight": {
"type": [
"integer",
"null"
],
"description": "Player's weight in pounds"
},
"BirthDate": {
"type": [
"string",
"null"
],
"description": "Player's date of birth"
},
"College": {
"type": [
"string",
"null"
],
"description": "College team the player played for prior to turning professional"
},
"Experience": {
"type": [
"integer",
"null"
],
"description": "Number of years experience. Note: This number is incremented every year; in the Spring; when we load the rookies following the NFL Draft. Rookies will have Experience = 0; while second year players will have Experience = 2."
},
"FantasyPosition": {
"type": [
"string",
"null"
],
"description": "The player's fantasy football position. Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL."
},
"Active": {
"type": [
"boolean",
"null"
],
"description": "Whether or not the player is on the active roster of the NFL team (True/False)"
},
"PositionCategory": {
"type": [
"string",
"null"
],
"description": "The category of the player's position (OFF; DEF; ST)"
},
"Name": {
"type": [
"string",
"null"
],
"description": "Player's full name"
},
"Age": {
"type": [
"integer",
"null"
],
"description": "The player's current age"
},
"ExperienceString": {
"type": [
"string",
"null"
],
"description": "The player's experience converted to a string"
},
"BirthDateString": {
"type": [
"string",
"null"
],
"description": "The player's date of birth converted to a string"
},
"PhotoUrl": {
"type": [
"string",
"null"
],
"description": "This field is deprecated. Note: Headshots are now delivered through IMAGN. Please see our Headshots products for further information."
},
"ByeWeek": {
"type": [
"integer",
"null"
],
"description": "The week the player is on bye for the upcoming or current season"
},
"UpcomingGameOpponent": {
"type": [
"string",
"null"
],
"description": "The opposing team the player is playing against in the upcoming week"
},
"UpcomingGameWeek": {
"type": "integer",
"description": "The week of the player's upcoming game (this will be the upcoming week unless the player is on Bye that week, which would bump it to the next week)"
},
"ShortName": {
"type": [
"string",
"null"
],
"description": "The first initial and last name of the player (J. Doe)"
},
"AverageDraftPosition": {
"type": [
"number",
"null"
],
"description": "The average draft position of the player in re-draft leagues"
},
"DepthPositionCategory": {
"type": [
"string",
"null"
],
"description": "The category (Offense, Defense or Special Teams) of the players DepthPositionCategory (OFF, DEF, ST)"
},
"DepthPosition": {
"type": [
"string",
"null"
],
"description": "The position this player is listed at on his team's depth chart (e.g. QB; LWR; RDE; LILB, K)"
},
"DepthOrder": {
"type": [
"integer",
"null"
],
"description": "The order this player is at his position (1 = Starter; 2 = Backup; 3 = 3rd String; 4 = 4th String; 5 = 5th String)"
},
"DepthDisplayOrder": {
"type": [
"integer",
"null"
],
"description": "The display order of the positions (for display purposes)"
},
"CurrentTeam": {
"type": [
"string",
"null"
],
"description": "The team who currently employs this player. This value is null when this player is unemployed (for example a free agent or retired player)."
},
"CollegeDraftTeam": {
"type": [
"string",
"null"
],
"description": "The team who drafted this player. Note: If this player was an Undrafted Free Agent; then it's the team who first signed him as a rookie."
},
"CollegeDraftYear": {
"type": [
"integer",
"null"
],
"description": "The year this player entered the NFL as a rookie"
},
"CollegeDraftRound": {
"type": [
"integer",
"null"
],
"description": "The round this player was drafted in"
},
"CollegeDraftPick": {
"type": [
"integer",
"null"
],
"description": "The overall pick in the draft this player was selected"
},
"IsUndraftedFreeAgent": {
"type": "boolean",
"description": "Whether this player was an undrafted free agent. This value is True if the player was not drafted."
},
"HeightFeet": {
"type": [
"integer",
"null"
],
"description": "The feet component of a player's height (if player is 6'3\", then this value would be 6)"
},
"HeightInches": {
"type": [
"integer",
"null"
],
"description": "The inches component of a player's height (if player is 6'3\", then this value would be 3)"
},
"UpcomingOpponentRank": {
"type": [
"integer",
"null"
],
"description": "The player's upcoming opponent's rank in fantasy points allowed"
},
"UpcomingOpponentPositionRank": {
"type": [
"integer",
"null"
],
"description": "The player's upcoming opponent's rank in fantasy points allowed to his fantasy position"
},
"CurrentStatus": {
"type": [
"string",
"null"
],
"description": "The player's current status. Possible values include Active, Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad, Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and Voluntary Opt Out. Inactive indicates that this player is a free agent. Active indicates that this player is on his team's active roster. Can also include injury status."
},
"UpcomingSalary": {
"type": [
"integer",
"null"
],
"description": "The player's salary for the upcoming week in accordance with a $50,000 salary cap. This is used for daily fantasy sports salary cap contests. Salaries represent those published by DraftKings. When DraftKings doesn't publish a salary for a given game; the most recent DraftKings salary is used. We recommend using our new DFS endpoints instead."
},
"FantasyAlarmPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to the FantasyAlarm news feed"
},
"SportRadarPlayerID": {
"type": [
"string",
"null"
],
"description": "The player's cross reference PlayerID to the SportRadar API"
},
"RotoworldPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to the Rotoworld news feed"
},
"RotoWirePlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to the RotoWire news feed"
},
"StatsPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to the STATS data feeds"
},
"SportsDirectPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to the SportsDirect data feeds, now part of Nielsen GraceNote"
},
"XmlTeamPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's unique PlayerID for cross reference use with XML Team data feeds"
},
"FanDuelPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to FanDuel"
},
"DraftKingsPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to DraftKings"
},
"YahooPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's unique PlayerID for cross reference use with Yahoo"
},
"InjuryStatus": {
"type": [
"string",
"null"
],
"description": "The player's current injury status, in the form of likelihood that player plays (Probable, Questionable, Doubtful, Out)"
},
"InjuryBodyPart": {
"type": [
"string",
"null"
],
"description": "The body part that is injured for the player (Knee; Groin; Calf; Hamstring; etc.)"
},
"InjuryStartDate": {
"type": [
"string",
"null"
],
"description": "The day that the player's injury started or was first discovered"
},
"InjuryNotes": {
"type": [
"string",
"null"
],
"description": "A brief description of the player's injury and expected availability"
},
"FanDuelName": {
"type": [
"string",
"null"
],
"description": "The player's full name in FanDuel's daily fantasy sports platform"
},
"DraftKingsName": {
"type": [
"string",
"null"
],
"description": "The player's full name in DraftKings' daily fantasy sports platform"
},
"YahooName": {
"type": [
"string",
"null"
],
"description": "The player's name in Yahoo's daily fantasy sports platform"
},
"FantasyPositionDepthOrder": {
"type": [
"integer",
"null"
],
"description": "The order this player is at his team's FantasyPosition"
},
"InjuryPractice": {
"type": [
"string",
"null"
],
"description": "This field is deprecated"
},
"InjuryPracticeDescription": {
"type": [
"string",
"null"
],
"description": "This field is deprecated"
},
"DeclaredInactive": {
"type": "boolean",
"description": "Whether the player has been declared inactive. This value is updated in the hours leading up to game start time; as teams announce their inactive players. Note: This is only updated for offensive skill position players (QB; RB; WR; TE)."
},
"UpcomingFanDuelSalary": {
"type": [
"integer",
"null"
],
"description": "The player's FanDuel salary for the upcoming week. Note: We recommend using our new DFS endpoints instead."
},
"UpcomingDraftKingsSalary": {
"type": [
"integer",
"null"
],
"description": "The player's DraftKings salary for the upcoming week. Note: We recommend using our new DFS endpoints instead."
},
"UpcomingYahooSalary": {
"type": [
"integer",
"null"
],
"description": "The player's Yahoo salary for the upcoming week. We recommend using our new DFS endpoints instead."
},
"TeamID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the team that the player is on. Note: If the player is a free agent; this field is NULL"
},
"GlobalTeamID": {
"type": [
"integer",
"null"
],
"description": "A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues."
},
"FantasyDraftPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to FantasyDraft"
},
"FantasyDraftName": {
"type": [
"string",
"null"
],
"description": "The player's full name in FantasyDraft's daily fantasy sports platform"
},
"UsaTodayPlayerID": {
"type": [
"integer",
"null"
],
"description": "The player's cross reference PlayerID to USA Today headshot data feeds"
},
"UsaTodayHeadshotUrl": {
"type": [
"string",
"null"
],
"description": "The player's headshot URL as provided by USA Today. License from USA Today is required."
},
"UsaTodayHeadshotNoBackgroundUrl": {
"type": [
"string",
"null"
],
"description": "The player's transparent background headshot URL as provided by USA Today. License from USA Today is required."
},
"UsaTodayHeadshotUpdated": {
"type": [
"string",
"null"
],
"description": "The last updated date of the player's headshot as provided by USA Today. License from USA Today is required."
},
"UsaTodayHeadshotNoBackgroundUpdated": {
"type": [
"string",
"null"
],
"description": "The last updated date of the player's transparent background headshot as provided by USA Today. License from USA Today is required."
}
}
}