stats.nba.com Endpoint Documentation

Lazaro Jr edited this page Jul 2, 2018 · 14 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:

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

Example:

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

boxscoreadvancedv2:

Parameters:

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

boxscorefourfactorsv2:

Parameters:

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

boxscoremiscv2:

Parameters:

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

boxscoreplayertrackv2:

Parameters:

  • GameID

boxscorescoringv2:

Parameters:

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

boxscoresummaryv2:

Parameters:

  • GameID

boxscoretraditionalv2:

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

playerdashptshotdefend:

Parameters:

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

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
  • PlayerPosition

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:

  • TeamID
  • Season
  • SeasonType
  • LeagueID

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:

c:

  • LeagueID
  • SeasonType
  • PerMode
  • TeamID

videoStatus:

Parameters:

  • LeagueID
  • GameDate

Parameters

LeagueID

NBA: 00 ABA: 01

TeamID

Current Teams

Team name TeamID
Atlanta Hawks 1610612737
Boston Celtics 1610612738
Brooklyn Nets 1610612751
Charlotte Hornets 1610612766
Chicago Bulls 1610612741
Cleveland Cavaliers 1610612739
Dallas Mavericks 1610612742
Denver Nuggets 1610612743
Detroit Pistons 1610612765
Golden State Warriors 1610612744
Houston Rockets 1610612745
Indiana Pacers 1610612754
Los Angeles Clippers 1610612746
Los Angeles Lakers 1610612747
Memphis Grizzlies 1610612763
Miami Heat 1610612748
Milwaukee Bucks 1610612749
Minnesota Timberwolves 1610612750
New Orleans Pelicans 1610612740
New York Knicks 1610612752
Oklahoma City Thunder 1610612760
Orlando Magic 1610612753
Philadelphia 76ers 1610612755
Phoenix Suns 1610612756
Portland Trail Blazers 1610612757
Sacramento Kings 1610612758
San Antonio Spurs 1610612759
Toronto Raptors 1610612761
Utah Jazz 1610612762
Washington Wizards 1610612764

Season:

Format: NNNN-NN (eg. 1995-96)

Game ID:

Format: 002"YY-1""Game Number" (eg. 0021600001, 2017 Season First Game)

SeasonType:

One of: "Regular Season", "Pre Season", "Playoffs", "All-Star", "All Star", "Preseason"

PerMode

"Totals", "PerGame", "Per36"

Scope

One of: "RS", "S", "Rookies"

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.