Skip to main content

Getting Started


Lifecycle:experimental PyPI Contributors Twitter

See CHANGELOG for details.

hoopR-py is an Python package for working with men’s basketball data and companion package to hoopR

The package has functions to access live play by play and box score data from ESPN with shot locations when available.


hoopR-py can be installed via pip:

pip install hoopR-py

or from the repo (which may at times be more up to date):

git clone hoopR-pypip install -e .

Our Authors#



To cite the hoopR-py Python package in publications, use:

BibTex Citation

@misc{saiemgilani2021hoopRpy,  author = {Gilani, Saiem},  title = {hoopR-py: The SportsDataverse's Python Package for Men's Basketball Data.},  url = {},  year = {2021}}