Repository files navigation

nba_api is an API Client forwww.nba.com. This package intends to make the APIs ofNBA.com easily accessible and provide extensive documentation about them.

nba_api requires Python 3.7+ along with therequests andnumpy packages. Whilepandas is not required, it is required to work with Pandas DataFrames.

pip install nba_api

fromnba_api.stats.endpointsimportplayercareerstats# Nikola Jokićcareer=playercareerstats.PlayerCareerStats(player_id='203999')# pandas data frames (optional: pip install pandas)career.get_data_frames()[0]# jsoncareer.get_json()# dictionarycareer.get_dict()

fromnba_api.live.nba.endpointsimportscoreboard# Today's Score Boardgames=scoreboard.ScoreBoard()# jsongames.get_json()# dictionarygames.get_dict()

• Requests/Response Options
  • Proxy Support, Custom Headers, and Timeout Settings
  • Return Types and Raw Responses
• Static Data Sets
  • Reduce HTTP requests for common and frequently accessed player and team data.
• Jupyter Notebooks
  • Practical examples in Jupyter Notebook format, including making basic calls, finding games, working with play-by-play data, and interacting with live game data.

• Table of Contents
• Package Structure
• Endpoints
• Static Data Sets
  • players.py
  • teams.py

JoinSlack to get help, help others, provide feedback, see amazing projects, participates in discussions, and collaborate with others from around the world.

Not a Slack fan? No problem. Head over toStackOverflow. Be sure to tag your post withnba-api.

SeeContributing to the NBA_API for complete details.

A significant purpose of this package is to continuously map and analyze as many endpoints on NBA.com as possible. The documentation and analysis of the endpoints and parameters in this package are some of the most extensive information available. At the same time, NBA.com does not provide information regarding new, changed, or removed endpoints.

If you find a new, changed, or deprecated endpoint, open aGitHub Issue

Encounter a bug,report a bug.

Thenba_api package is Open Source with anMIT License.

NBA.com has aTerms of Use regarding the use of the NBA’s digital platforms.