Getting Started

nba_api requires Python 3.10+ along with the requests and numpy packages. While pandas is not required, it is required to work with Pandas DataFrames.

pip install nba_api

NBA Official Stats

from nba_api.stats.endpoints import playercareerstats
Nikola Jokić
career = playercareerstats.PlayerCareerStats(player_id='203999')
pandas data frames (optional: pip install pandas)
career.seasontotalsregularseason.getdata_frame()
json
career.get_json()
dictionary
career.get_dict()

NBA Live Data

from nba_api.live.nba.endpoints import scoreboard
Today's Score Board
games = scoreboard.ScoreBoard()
json
games.get_json()
dictionary
games.get_dict()

Additional Examples

• Requests/Response Options

• Static Data Sets

• Jupyter Notebooks

Documentation

• Table of Contents
• Package Structure
• Endpoints
• Static Data Sets

Join the Community

Slack

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

Stack Overflow

Not a Slack fan? No problem. Head over to StackOverflow. Be sure to tag your post with nba-api.

Contributing

See Contributing to the NBA_API for complete details.

Endpoints

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 a GitHub Issue

Bugs

Encounter a bug, report a bug.

License & Terms of Use

API Client Package

The nbaapi package is Open Source with an MIT License.