nba_api

An API Client Package to Access the APIs of NBA

nba_apiis an API Client fornba.This package intends to make the APIs ofNBAeasily accessible and provide extensive documentation about them.

Getting Started

nba_apirequires Python 3.7+ along with therequestsandnumpypackages. Whilepandasis not required, it is required to work with Pandas DataFrames.

pip install nba_api

NBA Official Stats

fromnba_api.stats.endpointsimportplayercareerstats

# Nikola Jokić
career=playercareerstats.PlayerCareerStats(player_id='203999')

# pandas data frames (optional: pip install pandas)
career.get_data_frames()[0]

# json
career.get_json()

# dictionary
career.get_dict()

NBA Live Data

fromnba_api.live.nba.endpointsimportscoreboard

# Today's Score Board
games=scoreboard.ScoreBoard()

# json
games.get_json()

# dictionary
games.get_dict()

Additional Examples

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

Documentation

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

Join the Community

Slack

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

Stack Overflow

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

Contributing

SeeContributing to the NBA _APIfor complete details.

Endpoints

A significant purpose of this package is to continuously map and analyze as many endpoints on NBA 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 does not provide information regarding new, changed, or removed endpoints.

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

Bugs

Encounter a bug,report a bug.

License & Terms of Use

API Client Package

Thenba_apipackage is Open Source with anMIT License.

NBA

NBA has aTerms of Useregarding the use of the NBA ’s digital platforms.