stats.nba.com Endpoint Documentation

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:

Parameters:

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