sportrefpy 0.2.0

Python package to pull sports stats from all major sports leagues.

SPORTREFPY

Sportrefpy is package that pulls data from the Sports-Reference family of sites. Currently, only NBA is working but NHL, NFL, MLB, and College Basketball and Football will be supported as soon as possible.

Table of Contents

• Installation
• Usage
  • NBA
    • Initialize league, team, or player
    • Find Franchise Codes
    • Career Totals
    • Compare Players
    • Compare Franchises
    • Team-specific Player Stats
    • Team-specific Coach Stats
    • Roster
    • Current Season Standings
    • Get Franchise Season History
    • Find which seasons a team won the NBA Finals
  • NHL
    • Initialize a league, team, or player
    • Find Franchise Codes
    • Compare Franchises
    • Roster
    • Get Franchise Season History
    • Get Stanley Cup winning seasons
  • Saving Data

Installation

pip install sportrefpy

Usage

Below are some examples for ways that you can use Sports Stats.

NBA

Initialize a league, team, or player

from sportrefpy.nba.league import NBA
from sportrefpy.nba.team import NBAFranchise
from sportrefpy.nba.player import NBAPlayer

nba = NBA()
sixers = NBAFranchise('PHI')
the_answer = NBAPlayer('Allen Iverson')

Print out Franchise Codes (needed for initializing a team)

from sportrefpy.nba.league import NBA

nba = NBA()
nba.franchise_codes()

Find the career totals (regular + playoffs) of a specific player

from sportrefpy.nba.player import NBAPlayer

# For all stats
king = NBAPlayer('LeBron James')
king.career_totals()

# For a specific stats
beard = NBAPlayer('James Harden')
beard.career_totals(stats=['PTS', 'G'])

• stats is None by default. If provided, it must be a list even if only using 1.

Compare players stat totals

from sportrefpy.nba.analysis import compare_players

showtime = compare_players(["Shaquille O'Neal", "Kobe Bryant"], 
                            stats=['PTS', 'TRB'],
                            total='career')

• stats must be a list, with as many stats as you'd like. Required.
• total defaults to 'career', but can also be 'post' or 'reg'.

Compare Franchise W/L records

from sportrefpy.nba.analysis import compare_franchises

compare_franchises(['NYK', 'BOS'])

• must be a list of teams, even if only using 1.

Get stats of players for a specific Franchise

from sportrefpy.nba.team import NBAFranchise

bulls = NBAFranchise('CHI')

# All players that have ever played for the team
bulls.players_all_time_stats()

# Or just the GOAT
bulls.players_all_time_stats('Michael Jordan')

Get stats of coaches for a specific Franchise

from sportrefpy.nba.team import NBAFranchise

spurs = NBAFranchise('SAS')

# All coaches that have ever coached the team
spurs.coaches_all_time_data()

# Or just Pop
spurs.coaches_all_time_data('Gregg Popovich')

Get roster for a given season

from sportrefpy.nba.team import NBAFranchise

warriors = NBAFranchise('GSW')
warriors.roster(2016)

• use integer year that season ends in. This example returns the 2015-16 Golden State Warriors.

Get current season standings

from sportrefpy.nba.league import NBA

nba = NBA()

# Both conferences
east, west = nba.current_standings()

# Just one of them
west = nba.current_standings(conf='west')
east = nba.current_standings(conf='east')

Get franchise season history

from sportrefpy.nba.team import NBAFranchise

mavs = NBAFranchise('DAL')

# Get all seasons
mavs.season_history()

# Get an individual season
mavs.season_history(year='2010-11')

• year defaults to all seasons. For an individual season, it needs to be a string like in the above example.

Find which seasons a team won the NBA Finals

from sportrefpy.nba.team import NBAFranchise

pistons = NHLFranchise('DET')
seasons = pistons.season_history()
seasons[seasons['Playoffs']  == 'Won Finals']]

NHL

Initialize a league, team, or player

from sportrefpy.nhl.league import NHL
from sportrefpy.nhl.team import NHLFranchise
from sportrefpy.nhl.player import NHLPlayer

nhl = NHL()
flyers = NHL('PHI')
the_great_one = NHL('Wayne Gretzky')

Print out Franchise Codes (needed for initializing a team)

from sportrefpy.nhl.league import NHL

nhl = NHL()
nhl.franchise_codes()

Compare Franchise W/L records

from sportrefpy.nhl.analysis import compare_franchises

compare_franchises(['TBL', 'DET'])

• must be a list of teams, even if only using 1.

Get roster for a given season

from sportrefpy.nhl.team import NHLFranchise

blues = NHLFranchise('STL')
blues.roster(2019)

• use integer year that season ends in. This example returns the 2018-19 St. Louis Blues.

Get franchise season history

from sportrefpy.nhl.team import NHLFranchise

flames = NHLFranchise('CGY')

# Get all seasons
flames.season_history()

# Get an individual season
flames.season_history(year='1988-89')

• year defaults to all seasons. For an individual season, it needs to be a string like in the above example.

Get Stanley Cup winning seasons

from sportrefpy.nhl.team import NHLFranchise

leafs = NHLFranchise('TOR')
seasons = leafs.season_history()
seasons[seasons['Playoffs']  == 'Won Stanley Cup Final']]

Saving Data

You can write the data to a CSV, JSON, or other file just like you would a Pandas DataFrame

import pandas as pd
from sportrefpy.nba.analysis import compare_franchises

compare_franchises(['IND', 'MIL']).to_csv('comparison.csv')