Skip to main content

NBA (sportsdataverse.nba)

Data sources​

SourceAPIs / hostsFunctionsAuth
Highlightscurated "start here" functions8—
ESPNcdn.espn.com, site.api.espn.com, site.web.api.espn.com +1 more126none
sportsdataverse-data releasesgithub.com56none
NBA Stats APIstats.nba.com130none (curl_cffi chrome TLS impersonation)
NBA Official Injury Reportofficial.nba.com3none (static PDFs on ak-static.cms.nba.com)
Fox Sports APIapi.foxsports.com26none
Basketball-Referencewww.basketball-reference.com9none (slow, owner agreement)
RealGMbasketball.realgm.com18none
Public model datasetsdunksandthrees.com7none
Additional functionshand-written wrappers & helpers276—

ESPN​

ReferenceFunctions
ESPN site API (v2)24
ESPN web API (v3)5
ESPN core API (v2)82
ESPN FPI API (fitt v3)1
ESPN CDN API (cdn.espn.com)4
Hand-written wrappers10

sportsdataverse-data releases​

ReferenceFunctions
sportsdataverse-data releases45
Hand-written wrappers11

NBA Stats API​

ReferenceFunctions
NBA Stats API (stats.nba.com)128
Hand-written wrappers2

NBA Official Injury Report​

ReferenceFunctions
Hand-written wrappers3

Fox Sports API​

ReferenceFunctions
Hand-written wrappers26

Basketball-Reference​

ReferenceFunctions
Hand-written wrappers9

RealGM​

ReferenceFunctions
Hand-written wrappers18

Public model datasets​

ReferenceFunctions
Hand-written wrappers7

Tools and helpers​

Play-by-play processing​

Models and calculators​

Analytics​

Dates and seasons​

IDs and crosswalks​

See also​

  • sdvplot — court_coords() puts stats-API x_legacy / y_legacy shots on the court surface("nba") draws
  • sportypy — the regulation NBA court (and every other surface) sdvplot draws with

Examples​

Worked examples — executed notebooks rendered as pages (refreshed weekly against the live APIs):

Python ↔ R parity​

Each sportsdataverse function and its equivalent in the sister R package, hoopR. Same-named where possible; the R column links the package's pkgdown reference.

sportsdataverse.nba (Python)hoopR (R)
bref_awardsbref_awards
bref_draftbref_draft
bref_injuriesbref_injuries
bref_player_biosbref_player_bios
bref_player_game_logbref_player_game_log
bref_players_statsbref_players_stats
bref_standingsbref_standings
bref_team_rosterbref_team_roster
bref_teams_statsbref_teams_stats
espn_nba_awardespn_nba_award
espn_nba_calendarespn_nba_calendar
espn_nba_coachespn_nba_coach
espn_nba_coach_recordespn_nba_coach_record
espn_nba_coach_seasonespn_nba_coach_season
espn_nba_conferencesespn_nba_conferences
espn_nba_draftespn_nba_draft
espn_nba_franchiseespn_nba_franchise
espn_nba_franchisesespn_nba_franchises
espn_nba_game_allespn_nba_game_all
espn_nba_game_broadcastsespn_nba_game_broadcasts
espn_nba_game_oddsespn_nba_game_odds
espn_nba_game_official_detailespn_nba_game_official_detail
espn_nba_game_officialsespn_nba_game_officials
espn_nba_game_playespn_nba_game_play
espn_nba_game_play_personnelespn_nba_game_play_personnel
espn_nba_game_powerindexespn_nba_game_powerindex
espn_nba_game_predictorespn_nba_game_predictor
espn_nba_game_probabilitiesespn_nba_game_probabilities
espn_nba_game_propbetsespn_nba_game_propbets
espn_nba_game_rostersespn_nba_game_rosters
espn_nba_game_situationespn_nba_game_situation
espn_nba_game_team_leadersespn_nba_game_team_leaders
espn_nba_game_team_linescoresespn_nba_game_team_linescores
espn_nba_game_team_rosterespn_nba_game_team_roster
espn_nba_game_team_statisticsespn_nba_game_team_statistics
espn_nba_injuriesespn_nba_injuries
espn_nba_leadersespn_nba_leaders
espn_nba_newsespn_nba_news
espn_nba_pbpespn_nba_pbp
espn_nba_player_awardsespn_nba_player_awards
espn_nba_player_boxespn_nba_player_box
espn_nba_player_career_statsespn_nba_player_career_stats
espn_nba_player_contractsespn_nba_player_contracts
espn_nba_player_eventlogespn_nba_player_eventlog
espn_nba_player_gamelogespn_nba_player_gamelog
espn_nba_player_infoespn_nba_player_info
espn_nba_player_overviewespn_nba_player_overview
espn_nba_player_seasonsespn_nba_player_seasons
espn_nba_player_splitsespn_nba_player_splits
espn_nba_player_statisticslogespn_nba_player_statisticslog
espn_nba_player_statsespn_nba_player_stats
espn_nba_player_stats_v3espn_nba_player_stats_v3
espn_nba_positionespn_nba_position
espn_nba_positionsespn_nba_positions
espn_nba_scoreboardespn_nba_scoreboard
espn_nba_season_awardsespn_nba_season_awards
espn_nba_season_draftespn_nba_season_draft
espn_nba_season_groupespn_nba_season_group
espn_nba_season_group_childrenespn_nba_season_group_children
espn_nba_season_group_teamsespn_nba_season_group_teams
espn_nba_season_groupsespn_nba_season_groups
espn_nba_season_infoespn_nba_season_info
espn_nba_season_typeespn_nba_season_type
espn_nba_season_typesespn_nba_season_types
espn_nba_season_weekespn_nba_season_week
espn_nba_season_weeksespn_nba_season_weeks
espn_nba_seasonsespn_nba_seasons
espn_nba_standingsespn_nba_standings
espn_nba_teamespn_nba_team
espn_nba_team_boxespn_nba_team_box
espn_nba_team_injuriesespn_nba_team_injuries
espn_nba_team_leadersespn_nba_team_leaders
espn_nba_team_newsespn_nba_team_news
espn_nba_team_recordespn_nba_team_record
espn_nba_team_rosterespn_nba_team_roster
espn_nba_team_scheduleespn_nba_team_schedule
espn_nba_teamsespn_nba_teams
espn_nba_tournamentsespn_nba_tournaments
espn_nba_transactionsespn_nba_transactions
espn_nba_venuesespn_nba_venues
fox_nba_boxscorefox_nba_boxscore
fox_nba_league_leadersfox_nba_league_leaders
fox_nba_oddsfox_nba_odds
fox_nba_pbpfox_nba_pbp
fox_nba_standingsfox_nba_standings
fox_nba_team_gamelogfox_nba_team_gamelog
fox_nba_team_rosterfox_nba_team_roster
fox_nba_team_statsfox_nba_team_stats
fox_nba_teamsfox_nba_teams
hoopshype_salarieshoopshype_salaries
load_nba_draftload_nba_draft
load_nba_game_rostersload_nba_game_rosters
load_nba_group_aliasesload_nba_group_aliases
load_nba_group_seasonsload_nba_group_seasons
load_nba_groupsload_nba_groups
load_nba_officialsload_nba_officials
load_nba_pbpload_nba_pbp
load_nba_player_boxscoreload_nba_player_box
load_nba_player_coreload_nba_player_core
load_nba_player_crosswalkload_nba_player_crosswalk
load_nba_player_impactload_nba_player_impact
load_nba_player_season_statsload_nba_player_stats
load_nba_rostersload_nba_rosters
load_nba_scheduleload_nba_schedule
load_nba_schedule_crosswalkload_nba_schedule_crosswalk
load_nba_shotsload_nba_shots
load_nba_standingsload_nba_standings
load_nba_stats_coachesload_nba_stats_coaches
load_nba_stats_draftload_nba_stats_draft
load_nba_stats_game_lineupsload_nba_stats_game_lineups
load_nba_stats_game_rostersload_nba_stats_game_rosters
load_nba_stats_leaguedashload_nba_stats_leaguedash
load_nba_stats_lineupsload_nba_stats_lineups
load_nba_stats_officialsload_nba_stats_officials
load_nba_stats_pbpload_nba_stats_pbp
load_nba_stats_player_boxscoresload_nba_stats_player_boxscores
load_nba_stats_player_game_logsload_nba_stats_player_game_logs
load_nba_stats_player_season_statsload_nba_stats_player_season_stats
load_nba_stats_possessionsload_nba_stats_possessions
load_nba_stats_rostersload_nba_stats_rosters
load_nba_stats_schedulesload_nba_stats_schedule
load_nba_stats_shotsload_nba_stats_shots
load_nba_stats_standingsload_nba_stats_standings
load_nba_stats_team_boxscoresload_nba_stats_team_boxscores
load_nba_stats_team_season_statsload_nba_stats_team_season_stats
load_nba_team_boxscoreload_nba_team_box
load_nba_team_crosswalkload_nba_team_crosswalk
load_nba_team_group_seasonsload_nba_team_group_seasons
load_nba_team_season_statsload_nba_team_stats
most_recent_nba_seasonmost_recent_nba_season
nba_l2mnba_l2m
nba_l2m_gamesnba_l2m_games
nba_live_boxscorenba_live_boxscore
nba_live_pbpnba_live_pbp
nba_player_crosswalknba_player_crosswalk
nba_referee_assignmentsnba_referee_assignments
nba_schedule_crosswalknba_schedule_crosswalk
nba_stats_alltimeleadersgridsnba_alltimeleadersgrids
nba_stats_assistleadersnba_assistleaders
nba_stats_assisttrackernba_assisttracker
nba_stats_boxscoreadvancedv3nba_boxscoreadvancedv3
nba_stats_boxscoredefensivev2nba_boxscoredefensivev2
nba_stats_boxscorefourfactorsv3nba_boxscorefourfactorsv3
nba_stats_boxscorehustlev2nba_boxscorehustlev2
nba_stats_boxscorematchupsv3nba_boxscorematchupsv3
nba_stats_boxscoremiscv3nba_boxscoremiscv3
nba_stats_boxscoreplayertrackv3nba_boxscoreplayertrackv3
nba_stats_boxscorescoringv3nba_boxscorescoringv3
nba_stats_boxscoresummaryv2nba_boxscoresummaryv2
nba_stats_boxscoresummaryv3nba_boxscoresummaryv3
nba_stats_boxscoretraditionalv2nba_boxscoretraditionalv2
nba_stats_boxscoretraditionalv3nba_boxscoretraditionalv3
nba_stats_boxscoreusagev3nba_boxscoreusagev3
nba_stats_commonallplayersnba_commonallplayers
nba_stats_commonplayerinfonba_commonplayerinfo
nba_stats_commonplayoffseriesnba_commonplayoffseries
nba_stats_commonteamrosternba_commonteamroster
nba_stats_commonteamyearsnba_commonteamyears
nba_stats_cumestatsplayernba_cumestatsplayer
nba_stats_cumestatsplayergamesnba_cumestatsplayergames
nba_stats_cumestatsteamnba_cumestatsteam
nba_stats_cumestatsteamgamesnba_cumestatsteamgames
nba_stats_draftcombinedrillresultsnba_draftcombinedrillresults
nba_stats_draftcombinenonstationaryshootingnba_draftcombinenonstationaryshooting
nba_stats_draftcombineplayeranthronba_draftcombineplayeranthro
nba_stats_draftcombinespotshootingnba_draftcombinespotshooting
nba_stats_draftcombinestatsnba_draftcombinestats
nba_stats_drafthistorynba_drafthistory
nba_stats_fantasywidgetnba_fantasywidget
nba_stats_franchisehistorynba_franchisehistory
nba_stats_franchiseleadersnba_franchiseleaders
nba_stats_franchiseleaderswranknba_franchiseleaderswrank
nba_stats_franchiseplayersnba_franchiseplayers
nba_stats_gamerotationnba_gamerotation
nba_stats_homepageleadersnba_homepageleaders
nba_stats_homepagev2nba_homepagev2
nba_stats_hustlestatsboxscorenba_hustlestatsboxscore
nba_stats_infographicfanduelplayernba_infographicfanduelplayer
nba_stats_leaderstilesnba_leaderstiles
nba_stats_leaguedashlineupsnba_leaguedashlineups
nba_stats_leaguedashoppptshotnba_leaguedashoppptshot
nba_stats_leaguedashplayerbiostatsnba_leaguedashplayerbiostats
nba_stats_leaguedashplayerclutchnba_leaguedashplayerclutch
nba_stats_leaguedashplayerptshotnba_leaguedashplayerptshot
nba_stats_leaguedashplayershotlocationsnba_leaguedashplayershotlocations
nba_stats_leaguedashplayerstatsnba_leaguedashplayerstats
nba_stats_leaguedashptdefendnba_leaguedashptdefend
nba_stats_leaguedashptstatsnba_leaguedashptstats
nba_stats_leaguedashptteamdefendnba_leaguedashptteamdefend
nba_stats_leaguedashteamclutchnba_leaguedashteamclutch
nba_stats_leaguedashteamptshotnba_leaguedashteamptshot
nba_stats_leaguedashteamshotlocationsnba_leaguedashteamshotlocations
nba_stats_leaguedashteamstatsnba_leaguedashteamstats
nba_stats_leaguegamefindernba_leaguegamefinder
nba_stats_leaguegamelognba_leaguegamelog
nba_stats_leaguehustlestatsplayernba_leaguehustlestatsplayer
nba_stats_leaguehustlestatsteamnba_leaguehustlestatsteam
nba_stats_leagueleadersnba_leagueleaders
nba_stats_leaguelineupviznba_leaguelineupviz
nba_stats_leagueplayerondetailsnba_leagueplayerondetails
nba_stats_leagueseasonmatchupsnba_leagueseasonmatchups
nba_stats_leaguestandingsnba_leaguestandings
nba_stats_leaguestandingsv3nba_leaguestandingsv3
nba_stats_matchupsrollupnba_matchupsrollup
nba_stats_playbyplayv3nba_playbyplayv3
nba_stats_playerawardsnba_playerawards
nba_stats_playercareerbycollegerollupnba_playercareerbycollegerollup
nba_stats_playercareerstatsnba_playercareerstats
nba_stats_playercomparenba_playercompare
nba_stats_playerdashboardbyclutchnba_playerdashboardbyclutch
nba_stats_playerdashboardbygamesplitsnba_playerdashboardbygamesplits
nba_stats_playerdashboardbygeneralsplitsnba_playerdashboardbygeneralsplits
nba_stats_playerdashboardbylastngamesnba_playerdashboardbylastngames
nba_stats_playerdashboardbyopponentnba_playerdashboardbyopponent
nba_stats_playerdashboardbyshootingsplitsnba_playerdashboardbyshootingsplits
nba_stats_playerdashboardbyteamperformancenba_playerdashboardbyteamperformance
nba_stats_playerdashboardbyyearoveryearnba_playerdashboardbyyearoveryear
nba_stats_playerdashptpassnba_playerdashptpass
nba_stats_playerdashptrebnba_playerdashptreb
nba_stats_playerdashptshotdefendnba_playerdashptshotdefend
nba_stats_playerdashptshotsnba_playerdashptshots
nba_stats_playerestimatedmetricsnba_playerestimatedmetrics
nba_stats_playerfantasyprofilenba_playerfantasyprofile
nba_stats_playerfantasyprofilebargraphnba_playerfantasyprofilebargraph
nba_stats_playergamelognba_playergamelog
nba_stats_playergamelogsnba_playergamelogs
nba_stats_playergamestreakfindernba_playergamestreakfinder
nba_stats_playerindexnba_playerindex
nba_stats_playerprofilev2nba_playerprofilev2
nba_stats_playervsplayernba_playervsplayer
nba_stats_playoffpicturenba_playoffpicture
nba_stats_scheduleleaguev2nba_schedule
nba_stats_scheduleleaguev2intnba_scheduleleaguev2int
nba_stats_scoreboardv2nba_scoreboardv2
nba_stats_scoreboardv3nba_scoreboardv3
nba_stats_shotchartdetailnba_shotchartdetail
nba_stats_shotchartleaguewidenba_shotchartleaguewide
nba_stats_shotchartlineupdetailnba_shotchartlineupdetail
nba_stats_synergyplaytypesnba_synergyplaytypes
nba_stats_teamdashboardbyclutchnba_teamdashboardbyclutch
nba_stats_teamdashboardbygamesplitsnba_teamdashboardbygamesplits
nba_stats_teamdashboardbygeneralsplitsnba_teamdashboardbygeneralsplits
nba_stats_teamdashboardbylastngamesnba_teamdashboardbylastngames
nba_stats_teamdashboardbyopponentnba_teamdashboardbyopponent
nba_stats_teamdashboardbyshootingsplitsnba_teamdashboardbyshootingsplits
nba_stats_teamdashboardbyteamperformancenba_teamdashboardbyteamperformance
nba_stats_teamdashboardbyyearoveryearnba_teamdashboardbyyearoveryear
nba_stats_teamdashlineupsnba_teamdashlineups
nba_stats_teamdashptpassnba_teamdashptpass
nba_stats_teamdashptrebnba_teamdashptreb
nba_stats_teamdashptshotsnba_teamdashptshots
nba_stats_teamdetailsnba_teamdetails
nba_stats_teamestimatedmetricsnba_teamestimatedmetrics
nba_stats_teamgamelognba_teamgamelog
nba_stats_teamgamelogsnba_teamgamelogs
nba_stats_teaminfocommonnba_teaminfocommon
nba_stats_teamplayerdashboardnba_teamplayerdashboard
nba_stats_teamplayeronoffdetailsnba_teamplayeronoffdetails
nba_stats_teamplayeronoffsummarynba_teamplayeronoffsummary
nba_stats_teamvsplayernba_teamvsplayer
nba_stats_teamyearbyyearstatsnba_teamyearbyyearstats
nba_stats_videodetailsassetnba_videodetailsasset
nba_stats_videoeventsnba_videoevents
nba_stats_videoeventsassetnba_videoeventsasset
nba_stats_videostatusnba_videostatus
nba_team_crosswalknba_team_crosswalk
nbadraft_mock_draftnbadraft_mock_draft
realgm_coachesrealgm_coaches
realgm_draftrealgm_draft
realgm_draft_prospectsrealgm_draft_prospects
realgm_early_entryrealgm_early_entry
realgm_future_free_agentsrealgm_future_free_agents
realgm_gmsrealgm_gms
realgm_individual_gamesrealgm_individual_games
realgm_individual_seasonsrealgm_individual_seasons
realgm_player_statsrealgm_player_stats
realgm_playersrealgm_players
realgm_players_abroadrealgm_players_abroad
realgm_rookie_scalerealgm_rookie_scale
realgm_salary_caprealgm_salary_cap
realgm_standingsrealgm_standings
realgm_team_statsrealgm_team_stats
realgm_teamsrealgm_teams
realgm_transactionsrealgm_transactions
rotowire_injuriesrotowire_injuries
spotrac_team_capspotrac_team_cap
year_to_seasonyear_to_season