Skip to content

An easy-to-use Python utility to scrape basketball data off stats.nba.com.

License

Notifications You must be signed in to change notification settings

hqadeer/nba_scrape

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nba_scrape

An easy-to-use Python utility to scrape professional basketball data off stats.nba.com using Selenium and BeautifulSoup.

Installation:

pip install nba_scrape

Usage:

from nba_scrape import NBA

Example:

>>> league = NBA()

>>> lebron = league.get_player('lebron james')

>>> lebron.get_stat('pts', '2016-17', playoffs=True)

>>> 32.8

>>> lebron.get_stats(['pts', 'reb', 'ast', 'ts%'], '2015-18', mode='playoffs')

>>> {'2015-16': (26.3, 9.5, 7.6, 0.585), '2016-17': (32.8, 9.1, 7.8, 0.649), '2017-18': (34, 9.1, 9, 0.619)}

Get an instance of the NBA class:

league = NBA()

Get a player:

player = league.get_player(player_name)

OR

player = league.get_player_by_id(id_number)

Get a single stat:

player.get_stat(stat_name, season)

Get multiple stats (formatted as a dict with tuples as items):

player.get_stats([stat1, stat2, stat3], season_range, mode=mode)

(Possible modes are 'season', 'playoffs', or 'both'; 'season' is the default.)

Current functionality:

  1. Compile a list of all NBA players and their IDs when initializing the NBA class.

  2. Easily load all regular season and playoff stats off a player's career page to a SQLite database. Only the player's name is required as input.

  3. Retrieve all traditional stats and select advanced ones (such as True Shooting Percentage) via database queries; only the requested stats and seasons are required as input.

  4. Browser-agnostic; uses the best available browser or raises an error if no supported browser is available.

  5. Test suite to ensure correct statistics are returned.

About

An easy-to-use Python utility to scrape basketball data off stats.nba.com.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages