Home

This project is in no way affiliated with basketball-reference.com (and I hope the fine folks at Basketball Reference do not get too upset at me for creating and maintaining this project).

Please use this project responsibly as Basketball Reference is a very useful resource.

Background

This library was created for another Python project where I was trying to estimate an NBA player's productivity (for, uh, daily fantasy sports "science").

A lot of sports-related APIs are expensive - luckily, Basketball Reference provides a free service which can be scraped and translated into a usable API.

Installation

This project is published to PyPi.

It can be installed via pip.

pip install basketball_reference_web_scraper

Note

This library requires Python 3.10+ and attempts to mirror the officially supported Python versions

Note

Currently, only NBA teams are supported. ABA/BAA teams are currently not fully supported.

Note

There is only one supported major version: 4.x.x.

Contributors

This is an open-source project that welcomes all pull requests and issues - I would love to hear your thoughts and ideas around making this project even better.

Thanks to @DaiJunyan, @ecallahan5, @Yotamho, @ntsirakis, @allanbelliti, @krlu, and @aaronbannin for their contributions!