Skip to content
This repository has been archived by the owner on Nov 1, 2021. It is now read-only.

stats.nba.com Endpoint Documentation

Eli edited this page Sep 9, 2015 · 15 revisions

Endpoints

This is more of a placeholder as of now but will later be tidied up and categoried.

I could use some help identifying what each parameter does and so forth but that'll come later.

All of the parameters were pulled directly from stats.nba.com using each endpoint and have been verified to work.

Usage:

https://stats.nba.com/stats/{endpoint}/?{params}

Example:

https://stats.nba.com/stats/scoreboard/?GameDate=02/14/2015&LeagueID=00&DayOffset=0

allstarballotpredictor:

Parameters:

  • PointCap
  • WestPlayer1
  • WestPlayer2
  • WestPlayer3
  • WestPlayer4
  • WestPlayer5
  • EastPlayer1
  • EastPlayer2
  • EastPlayer3
  • EastPlayer4
  • EastPlayer5

boxscore:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoreadvanced:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoreadvancedv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscorefourfactors:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscorefourfactorsv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoremisc:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoremiscv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoreplayertrackv2:

Parameters:

  • GameID

boxscorescoring:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscorescoringv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoresummaryv2:

Parameters:

  • GameID

boxscoretraditionalv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoreusage:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

boxscoreusagev2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod
  • StartRange
  • EndRange
  • RangeType

commonTeamYears:

Parameters:

  • LeagueID

commonallplayers:

Parameters:

  • LeagueID
  • Season
  • IsOnlyCurrentSeason

commonplayerinfo:

Parameters:

  • PlayerID

commonplayoffseries:

Parameters:

  • LeagueID
  • Season

commonteamroster:

Parameters:

  • Season
  • TeamID

draftcombinedrillresults:

Parameters:

  • LeagueID
  • SeasonYear

draftcombinenonstationaryshooting:

Parameters:

  • LeagueID
  • SeasonYear

draftcombineplayeranthro:

Parameters:

  • LeagueID
  • SeasonYear

draftcombinespotshooting:

Parameters:

  • LeagueID
  • SeasonYear

draftcombinestats:

Parameters:

  • LeagueID
  • SeasonYear

drafthistory:

Parameters:

  • LeagueID

franchisehistory:

Parameters:

  • LeagueID

homepageleaders:

Parameters:

  • StatCategory
  • LeagueID
  • Season
  • SeasonType
  • PlayerOrTeam
  • Game
  • Scope
  • Player
  • Scope

homepagev2:

Parameters:

  • StatType
  • LeagueID
  • Season
  • SeasonType
  • PlayerOrTeam
  • Game
  • Scope
  • Player
  • Scope

leaderstiles:

Parameters:

  • Stat
  • LeagueID
  • Season
  • SeasonType
  • PlayerOrTeam
  • Game
  • Scope
  • Player
  • Scope

leaguedashlineups:

Parameters:

  • GroupQuantity
  • SeasonType
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

leaguedashplayerbiostats:

Parameters:

  • PerMode
  • LeagueID
  • Season
  • SeasonType

leaguedashplayerclutch:

Parameters:

  • ClutchTime
  • AheadBehind
  • PointDiff
  • GameScope
  • PlayerExperience
  • PlayerPosition
  • StarterBench
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

leaguedashplayerptshot:

Parameters:

  • LeagueID
  • PerMode
  • Season
  • SeasonType

leaguedashplayershotlocations:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames
  • DistanceRange
  • GameScope
  • PlayerExperience
  • PlayerPosition
  • StarterBench

leaguedashplayerstats:

Parameters:

  • GameScope
  • PlayerExperience
  • PlayerPosition
  • StarterBench
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

leaguedashptdefend:

Parameters:

  • LeagueID
  • PerMode
  • Season
  • SeasonType
  • DefenseCategory

leaguedashptteamdefend:

Parameters:

  • LeagueID
  • PerMode
  • Season
  • SeasonType
  • DefenseCategory

leaguedashteamclutch:

Parameters:

  • ClutchTime
  • AheadBehind
  • PointDiff
  • GameScope
  • PlayerExperience
  • PlayerPosition
  • StarterBench
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

leaguedashteamptshot:

Parameters:

  • LeagueID
  • PerMode
  • Season
  • SeasonType

leaguedashteamshotlocations:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames
  • DistanceRange
  • GameScope
  • PlayerExperience
  • PlayerPosition
  • StarterBench

leaguedashteamstats:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

leagueleaders:

Parameters:

  • LeagueID
  • PerMode
  • StatCategory
  • Season
  • SeasonType
  • Scope

playbyplay:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod

playbyplayv2:

Parameters:

  • GameID
  • StartPeriod
  • EndPeriod

playercareerstats:

Parameters:

  • PerMode
  • PlayerID

playercompare:

Parameters:

  • PlayerIDList
  • VsPlayerIDList
  • SeasonType
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbyclutch:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbygamesplits:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbygeneralsplits:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbylastngames:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbyopponent:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbyshootingsplits:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbyteamperformance:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashboardbyyearoveryear:

Parameters:

  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • PlayerID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashptpass:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • PlayerID
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • LastNGames

playerdashptreb:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • PlayerID
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashptreboundlogs:

Parameters:

  • Season
  • SeasonType
  • PlayerID
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashptshotdefend:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • PlayerID
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playerdashptshotlog:

Parameters:

  • LeagueID
  • Season
  • SeasonType
  • PlayerID
  • TeamID

playerdashptshots:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • PlayerID
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playergamelog:

Parameters:

  • PlayerID
  • Season
  • SeasonType

playerprofile:

Parameters:

  • LeagueID
  • PlayerID
  • Season
  • SeasonType
  • GraphStartSeason
  • GraphEndSeason
  • GraphStat

playerprofilev2:

Parameters:

  • PerMode
  • PlayerID

playersvsplayers:

Parameters:

  • PlayerTeamID
  • PlayerID1
  • PlayerID2
  • PlayerID3
  • PlayerID4
  • PlayerID5
  • VsTeamID
  • VsPlayerID1
  • VsPlayerID2
  • VsPlayerID3
  • VsPlayerID4
  • VsPlayerID5
  • SeasonType
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playervsplayer:

Parameters:

  • PlayerID
  • VsPlayerID
  • SeasonType
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

playoffpicture:

Parameters:

  • LeagueID
  • SeasonID

scoreboard:

Parameters:

  • GameDate
  • LeagueID
  • DayOffset

scoreboardV2:

Parameters:

  • GameDate
  • LeagueID
  • DayOffset

shotchartdetail:

Parameters:

  • SeasonType
  • TeamID
  • PlayerID
  • GameID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • Position
  • RookieYear
  • GameSegment
  • Period
  • LastNGames
  • ContextMeasure

shotchartlineupdetail:

Parameters:

  • LeagueID
  • Season
  • SeasonType
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames
  • GameID
  • GROUP_ID
  • ContextMeasure
  • ContextFilter

teamdashboardbyclutch:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbygamesplits:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbygeneralsplits:

Parameters:

  • SeasonType
  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbylastngames:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbyopponent:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbyshootingsplits:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbyteamperformance:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashboardbyyearoveryear:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashlineups:

Parameters:

  • GroupQuantity
  • GameID
  • SeasonType
  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashptpass:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • LastNGames

teamdashptreb:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamdashptshots:

Parameters:

  • PerMode
  • Season
  • SeasonType
  • TeamID
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamgamelog:

Parameters:

  • TeamID
  • Season
  • SeasonType

teaminfocommon:

Parameters:

  • Season
  • TeamID
  • LeagueID
  • SeasonType

teamplayerdashboard:

Parameters:

  • SeasonType
  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamplayeronoffdetails:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamplayeronoffsummary:

Parameters:

  • TeamID
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • SeasonType
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamvsplayer:

Parameters:

  • TeamID
  • VsPlayerID
  • SeasonType
  • MeasureType
  • PerMode
  • PlusMinus
  • PaceAdjust
  • Rank
  • Season
  • Outcome
  • Location
  • Month
  • SeasonSegment
  • DateFrom
  • DateTo
  • OpponentTeamID
  • VsConference
  • VsDivision
  • GameSegment
  • Period
  • LastNGames

teamyearbyyearstats:

Parameters:

  • LeagueID
  • SeasonType
  • PerMode
  • TeamID

videoStatus:

Parameters:

  • LeagueID
  • GameDate
Clone this wiki locally