Skip to main content

An API Client package to access the APIs for NBA.com

Project description

PyPI CircleCI (all branches) GitHub GitHub

nba_api

An API Client package to access the APIs for NBA.com

Development Version: v1.1.11

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

The APIs on www.nba.com 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.nba.com - stats

Have Questions or Need Help?

Please try to avoid sending questions to my personal email that regard researching a solution to your specific problem. I don't mind helping, but the library has been setup with expansive documentation that should be checked first prior to reaching out to me personally. Alternatively, there are other places where you can ask for general advice that has been listed below.

Slack Channel

There has been a public slack channel that has been setup for people to chat and receive help.

Stack Overflow

A tag has been set up for people to use when asking for help on Stack Overflow. Please tag posts with the nba-api tag.

Use

Installation

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.

Documentation

Contributing and Development

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.

Testing

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

pytest

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.

Contributing

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.

Other

Endpoint Analysis

A major purpose of this package is to map and analyze as many endpoints on NBA.com 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.

Source Distribution

nba_api-1.1.11.tar.gz (125.6 kB view details)

Uploaded Source

File details

Details for the file nba_api-1.1.11.tar.gz.

File metadata

  • Download URL: nba_api-1.1.11.tar.gz
  • Upload date:
  • Size: 125.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.9

File hashes

Hashes for nba_api-1.1.11.tar.gz
Algorithm Hash digest
SHA256 b62d9836b398a00a81577a45888707a14a1b1fd393aa7ad4e81f40193f516f15
MD5 a5ea172f3dffff983694e0b1b864b7b3
BLAKE2b-256 cb0bff3d852e79e1ff6baec02f4ee4dd6677eac1ccd04815c4168da451967c33

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page