This project is designed to allow people to scrape Play by Play and Shift data off of the National Hockey League (NHL) API and website for all regular season and playoff games since the 2010-2011 season
Project description
This project is designed to allow people to scrape Play by Play and Shift data off of the National Hockey League (NHL) API and website for all regular season and playoff games since the 2010-2011 season (further testing needs to be done to ensure it works for earlier seasons).
Prerequisites
You are going to need to have python installed for this. Specifically, you’ll need from at least version 3.6.0.
If you don’t have python installed on your machine, I’d recommend installing it through the anaconda distribution (here - https://www.continuum.io/downloads). Anaconda comes with a bunch of libraries pre-installed so it’ll be easier to start off.
How to Use
To install just open up your terminal and type in:
pip install hockey_scraper
There are three relevant functions used for scraping data (After any scraping function finishes running, the data scraped can be found in the folder which contains your code):
1. scrape_seasons:
This function is used to scrape on a season by season level. It takes two arguments:
‘seasons’ - List of seasons you want to scrape (Note: A given season is referred to by the first of the two years it spans. So you would refer to the 2016-2017 season as 2016.
‘if_scrape_shifts’ - Boolean indicating whether or not you want to scrape the shifts too.
# Scrapes 2015 & 2016 season with shifts scrape_functions.scrape_seasons([2015, 2016], True) # Scrapes 2016 season without shifts scrape_functions.scrape_seasons([2016], False)
2. scrape_games:
This function is used to scrape any collection of games you want. It takes two arguments:
‘games’ - List of games you want to scrape. A game is identified by the game id used by the NHL (ex: 2016020001). The list of corresponding id’s for games can be found here (https://statsapi.web.nhl.com/api/v1/schedule?startDate=2016-10-12&endDate=2016-10-12 - Just fiddle with the start and end dates in the url to find the game you are looking for).
‘if_scrape_shifts’ - Boolean indicating whether or not you want to scrape the shifts too.
# Scrapes first game of 2014, 2015, and 2016 seasons with shifts scrape_functions.scrape_games([2014020001, 2015020001, 2016020001], True)
3. scrape_date_range:
This functions is used to scrape any games in a given date range. All dates must be written in the following format yyyy-mm-dd (ex: ‘2016-10-20’). It take three arguments:
‘from_date’ - Date of beginning of interval you want to scrape
‘to_date’ - Date of end of interval you want to scrape
‘if_scrape_shifts’ - Boolean indicating whether or not you want to scrape the shifts too.
# Scrapes games between 2016-10-10 and 2016-10-20 without shifts scrape_functions.scrape_date_range('2016-10-10', '2016-10-20', False)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hockey_scraper-1.0.1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 51f69a3d1b1ba44e3e5b16f1284cfba0a27b87c7ec2ed09d9b489cfac4b67c3e |
|
| MD5 | 80d3db13e083b8205618b9e2c89772ff |
|
| BLAKE2b-256 | c535fa23430ae2046c91bc9e5ba4cac193629bc914814d62a5a4c9ce961d65d1 |
