Skip to main content

nba_playervsplayer

Endpoint URL#

https://stats.nba.com/stats/playervsplayer

Valid URL#

https://stats.nba.com/stats/playervsplayer?DateFrom=&DateTo=&GameSegment=&LastNGames=0&LeagueID=&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerID=2544&PlusMinus=N&Rank=N&Season=2019-20&SeasonSegment=&SeasonType=Regular+Season&VsConference=&VsDivision=&VsPlayerID=2544

Parameters#

API Parameter NameParameterPatternRequiredNullable
LastNGameslast_n_gamesY
MeasureTypemeasure_type_detailed_defense^(Base)\|(Advanced)\|(Misc)\|(Four Factors)\|(Scoring)\|(Opponent)\|(Usage)\|(Defense)$Y
MonthmonthY
OpponentTeamIDopponent_team_idY
PaceAdjustpace_adjust^(Y)\|(N)$Y
PerModeper_mode_detailed^(Totals)\|(PerGame)\|(MinutesPer)\|(Per48)\|(Per40)\|(Per36)\|(PerMinute)\|(PerPossession)\|(PerPlay)\|(Per100Possessions)\|(Per100Plays)$Y
PeriodperiodY
PlayerIDplayer_idY
PlusMinusplus_minus^(Y)\|(N)$Y
Rankrank^(Y)\|(N)$Y
SeasonseasonY
SeasonTypeseason_type_playoffs^(Regular Season)\|(Pre Season)\|(Playoffs)$Y
VsPlayerIDvs_player_idY
VsDivisionvs_division_nullable^((Atlantic)\|(Central)\|(Northwest)\|(Pacific)\|(Southeast)\|(Southwest)\|(East)\|(West))?$YY
VsConferencevs_conference_nullable^((East)\|(West))?$YY
SeasonSegmentseason_segment_nullable^((Post All-Star)\|(Pre All-Star))?$YY
Outcomeoutcome_nullable^((W)\|(L))?$YY
Locationlocation_nullable^((Home)\|(Road))?$YY
LeagueIDleague_id_nullableY
GameSegmentgame_segment_nullable^((First Half)\|(Overtime)\|(Second Half))?$YY
DateTodate_to_nullableYY
DateFromdate_from_nullableYY

Data Sets#

OnOffCourt on_off_court#

['GROUP_SET', 'PLAYER_ID', 'PLAYER_NAME', 'VS_PLAYER_ID', 'VS_PLAYER_NAME', 'COURT_STATUS', 'GP', 'W', 'L', 'W_PCT', 'MIN', 'FGM', 'FGA', 'FG_PCT', 'FG3M', 'FG3A', 'FG3_PCT', 'FTM', 'FTA', 'FT_PCT', 'OREB', 'DREB', 'REB', 'AST', 'TOV', 'STL', 'BLK', 'BLKA', 'PF', 'PFD', 'PTS', 'PLUS_MINUS', 'NBA_FANTASY_PTS', 'CFID', 'CFPARAMS']

Overall overall#

['GROUP_SET', 'GROUP_VALUE', 'PLAYER_ID', 'PLAYER_NAME', 'GP', 'W', 'L', 'W_PCT', 'MIN', 'FGM', 'FGA', 'FG_PCT', 'FG3M', 'FG3A', 'FG3_PCT', 'FTM', 'FTA', 'FT_PCT', 'OREB', 'DREB', 'REB', 'AST', 'TOV', 'STL', 'BLK', 'BLKA', 'PF', 'PFD', 'PTS', 'PLUS_MINUS', 'NBA_FANTASY_PTS', 'CFID', 'CFPARAMS']

PlayerInfo player_info#

['PERSON_ID', 'FIRST_NAME', 'LAST_NAME', 'DISPLAY_FIRST_LAST', 'DISPLAY_LAST_COMMA_FIRST', 'DISPLAY_FI_LAST', 'BIRTHDATE', 'SCHOOL', 'COUNTRY', 'LAST_AFFILIATION']

ShotAreaOffCourt shot_area_off_court#

['GROUP_SET', 'PLAYER_ID', 'PLAYER_NAME', 'VS_PLAYER_ID', 'VS_PLAYER_NAME', 'COURT_STATUS', 'GROUP_VALUE', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

ShotAreaOnCourt shot_area_on_court#

['GROUP_SET', 'PLAYER_ID', 'PLAYER_NAME', 'VS_PLAYER_ID', 'VS_PLAYER_NAME', 'COURT_STATUS', 'GROUP_VALUE', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

ShotAreaOverall shot_area_overall#

['GROUP_SET', 'GROUP_VALUE', 'PLAYER_ID', 'PLAYER_NAME', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

ShotDistanceOffCourt shot_distance_off_court#

['GROUP_SET', 'PLAYER_ID', 'PLAYER_NAME', 'VS_PLAYER_ID', 'VS_PLAYER_NAME', 'COURT_STATUS', 'GROUP_VALUE', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

ShotDistanceOnCourt shot_distance_on_court#

['GROUP_SET', 'PLAYER_ID', 'PLAYER_NAME', 'VS_PLAYER_ID', 'VS_PLAYER_NAME', 'COURT_STATUS', 'GROUP_VALUE', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

ShotDistanceOverall shot_distance_overall#

['GROUP_SET', 'GROUP_VALUE', 'PLAYER_ID', 'PLAYER_NAME', 'FGM', 'FGA', 'FG_PCT', 'CFID', 'CFPARAMS']

VsPlayerInfo vs_player_info#

['PERSON_ID', 'FIRST_NAME', 'LAST_NAME', 'DISPLAY_FIRST_LAST', 'DISPLAY_LAST_COMMA_FIRST', 'DISPLAY_FI_LAST', 'BIRTHDATE', 'SCHOOL', 'COUNTRY', 'LAST_AFFILIATION']

JSON#

{    "data_sets": {        "OnOffCourt": [            "GROUP_SET",            "PLAYER_ID",            "PLAYER_NAME",            "VS_PLAYER_ID",            "VS_PLAYER_NAME",            "COURT_STATUS",            "GP",            "W",            "L",            "W_PCT",            "MIN",            "FGM",            "FGA",            "FG_PCT",            "FG3M",            "FG3A",            "FG3_PCT",            "FTM",            "FTA",            "FT_PCT",            "OREB",            "DREB",            "REB",            "AST",            "TOV",            "STL",            "BLK",            "BLKA",            "PF",            "PFD",            "PTS",            "PLUS_MINUS",            "NBA_FANTASY_PTS",            "CFID",            "CFPARAMS"        ],        "Overall": [            "GROUP_SET",            "GROUP_VALUE",            "PLAYER_ID",            "PLAYER_NAME",            "GP",            "W",            "L",            "W_PCT",            "MIN",            "FGM",            "FGA",            "FG_PCT",            "FG3M",            "FG3A",            "FG3_PCT",            "FTM",            "FTA",            "FT_PCT",            "OREB",            "DREB",            "REB",            "AST",            "TOV",            "STL",            "BLK",            "BLKA",            "PF",            "PFD",            "PTS",            "PLUS_MINUS",            "NBA_FANTASY_PTS",            "CFID",            "CFPARAMS"        ],        "PlayerInfo": [            "PERSON_ID",            "FIRST_NAME",            "LAST_NAME",            "DISPLAY_FIRST_LAST",            "DISPLAY_LAST_COMMA_FIRST",            "DISPLAY_FI_LAST",            "BIRTHDATE",            "SCHOOL",            "COUNTRY",            "LAST_AFFILIATION"        ],        "ShotAreaOffCourt": [            "GROUP_SET",            "PLAYER_ID",            "PLAYER_NAME",            "VS_PLAYER_ID",            "VS_PLAYER_NAME",            "COURT_STATUS",            "GROUP_VALUE",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "ShotAreaOnCourt": [            "GROUP_SET",            "PLAYER_ID",            "PLAYER_NAME",            "VS_PLAYER_ID",            "VS_PLAYER_NAME",            "COURT_STATUS",            "GROUP_VALUE",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "ShotAreaOverall": [            "GROUP_SET",            "GROUP_VALUE",            "PLAYER_ID",            "PLAYER_NAME",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "ShotDistanceOffCourt": [            "GROUP_SET",            "PLAYER_ID",            "PLAYER_NAME",            "VS_PLAYER_ID",            "VS_PLAYER_NAME",            "COURT_STATUS",            "GROUP_VALUE",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "ShotDistanceOnCourt": [            "GROUP_SET",            "PLAYER_ID",            "PLAYER_NAME",            "VS_PLAYER_ID",            "VS_PLAYER_NAME",            "COURT_STATUS",            "GROUP_VALUE",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "ShotDistanceOverall": [            "GROUP_SET",            "GROUP_VALUE",            "PLAYER_ID",            "PLAYER_NAME",            "FGM",            "FGA",            "FG_PCT",            "CFID",            "CFPARAMS"        ],        "VsPlayerInfo": [            "PERSON_ID",            "FIRST_NAME",            "LAST_NAME",            "DISPLAY_FIRST_LAST",            "DISPLAY_LAST_COMMA_FIRST",            "DISPLAY_FI_LAST",            "BIRTHDATE",            "SCHOOL",            "COUNTRY",            "LAST_AFFILIATION"        ]    },    "endpoint": "PlayerVsPlayer",    "last_validated_date": "2020-08-15",    "nullable_parameters": [        "DateFrom",        "DateTo",        "GameSegment",        "LeagueID",        "Location",        "Outcome",        "SeasonSegment",        "VsConference",        "VsDivision"    ],    "parameter_patterns": {        "DateFrom": null,        "DateTo": null,        "GameSegment": "^((First Half)|(Overtime)|(Second Half))?$",        "LastNGames": null,        "LeagueID": null,        "Location": "^((Home)|(Road))?$",        "MeasureType": "^(Base)|(Advanced)|(Misc)|(Four Factors)|(Scoring)|(Opponent)|(Usage)|(Defense)$",        "Month": null,        "OpponentTeamID": null,        "Outcome": "^((W)|(L))?$",        "PaceAdjust": "^(Y)|(N)$",        "PerMode": "^(Totals)|(PerGame)|(MinutesPer)|(Per48)|(Per40)|(Per36)|(PerMinute)|(PerPossession)|(PerPlay)|(Per100Possessions)|(Per100Plays)$",        "Period": null,        "PlayerID": null,        "PlusMinus": "^(Y)|(N)$",        "Rank": "^(Y)|(N)$",        "Season": null,        "SeasonSegment": "^((Post All-Star)|(Pre All-Star))?$",        "SeasonType": "^(Regular Season)|(Pre Season)|(Playoffs)$",        "VsConference": "^((East)|(West))?$",        "VsDivision": "^((Atlantic)|(Central)|(Northwest)|(Pacific)|(Southeast)|(Southwest)|(East)|(West))?$",        "VsPlayerID": null    },    "parameters": [        "DateFrom",        "DateTo",        "GameSegment",        "LastNGames",        "LeagueID",        "Location",        "MeasureType",        "Month",        "OpponentTeamID",        "Outcome",        "PaceAdjust",        "PerMode",        "Period",        "PlayerID",        "PlusMinus",        "Rank",        "Season",        "SeasonSegment",        "SeasonType",        "VsConference",        "VsDivision",        "VsPlayerID"    ],    "required_parameters": [        "DateFrom",        "DateTo",        "GameSegment",        "LastNGames",        "Location",        "MeasureType",        "Month",        "OpponentTeamID",        "Outcome",        "PaceAdjust",        "PerMode",        "Period",        "PlayerID",        "PlusMinus",        "Rank",        "Season",        "SeasonSegment",        "SeasonType",        "VsConference",        "VsDivision",        "VsPlayerID"    ],    "status": "success"}

Last validated 2020-08-16