Skip to main content

An API Client package to access the APIs for

Project description

PyPI CircleCI (all branches) GitHub GitHub


An API Client package to access the APIs for

Development Version: v1.1.8

nba_api is an API Client for This package is meant to make the API Endpoints more accessible and to provide extensive documentation.

The APIs on are largely undocumented and change frequently.

Please feel free to contribute and have an open discussion regarding improvements and additional APIs to be mapped.

Recent Changes

  • Adding individual proxy, headers, and timeout support for requests. Usage

Mapped API Clients

  1. - stats



pip install nba_api

Required and Optional Packages:

Usage Examples

  • Basic Usage -- The basics of calling an API endpoint.
  • Jupyter Notebooks -- Larger practical examples in Jupyter Notebook format, including looking for play-by-play data for a particular game.


Contributing and Development


To get started developing, clone the repo and cd into it. Then, in an environment (conda or virtualenv) where you have not yet installed nba_api, run

python -m pip install -e .

This command will install the package for development, such that any changes you make in the repo will be reflected the next time you import the package in Python.


If you make a change to the package, it's important to verify everything still works. Do so by first installing the package for development, with the -e flag (see Development above), and then running


on the command line from the base directory of the repo. The pytest utility will run through all the package tests and print output throughout, informing you of any failures.


We're always looking for people to help! Some examples of ways to get involved are:

  • fix a bug
  • add a feature
  • create or improve documentation and examples

Just fork this repo, make your changes (see Development above), and issue a pull request.


Endpoint Analysis

A major purpose of this package is to map and analyze as many endpoints on as possible. The documentation and analysis on the Endpoints and Parameters found in this package is some of the most extensive information available on these largely undocumented Endpoints. Please open an issue with any additional Endpoints/APIs.

Examples for Other Clients

Endpoint Analysis JSON for use with other clients

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nba-api, version 1.1.8
Filename, size File type Python version Upload date Hashes
Filename, size nba_api-1.1.8-py3-none-any.whl (217.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size nba_api-1.1.8.tar.gz (111.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page