nhl-api-py 0.2.0

NHL API Wrapper. For standings, team stats and outcomes.

NHL-API-PY

NHL-api-py is a Python package that provides a simple wrapper around the NHL API, allowing you to easily access and retrieve NHL data in your Python applications.

Note: This is very early, I created this to help me with some machine learning projects around the NHL and the NHL data sets. Special thanks to https://github.com/erunion/sport-api-specifications/tree/master/nhl and https://gitlab.com/dword4/nhlapi/-/blob/master/stats-api.md.

Example Notebook:

An example Collab notebook can be found here at coreyjs/nhl-api-py-examples.

Installation

You can install NHL-py-api using pip:

pip install nhl-api-py

---

Usage

from nhlpy import NHLClient

client = NHLClient()

Available methods:

client.teams.all()
client.teams.get_by_id(id=1, roster=False)
client.teams.get_team_next_game(id=1)
client.teams.get_team_previous_game(id=1)
client.teams.get_team_stats(id=1)

# Standings
client.standings.get_standings(season="20222023", detailed_record=False)
client.standings.get_standing_types()

# Player Stats
client.players.get_player_stats(person_id=8477949, season="20222023", stat_type="statsSingleSeason")
client.players.get_player_stats(person_id=8477949, season="20222023", stat_type="goalsByGameSituation")
client.players.get_player_stats(person_id=8477949, season="20222023", stat_type="yearByYear")

---

As mentioned at the top, I created a notebook to go over some of the available methods in more detail. Below is an export md of that notebook, with out cell executions.

pip install nhl-api-py

from nhlpy import NHLClient

Getting Started - Create the NHLClient

client = NHLClient()

Team APIs

teams = client.teams.all()
teams

buffalo = client.teams.get_by_id(id=7)
buffalo

next_buffalo_game = client.teams.get_team_next_game(id=7)
next_buffalo_game

prev_buffalo_game = client.teams.get_team_previous_game(id=7)
prev_buffalo_game

buffalo_with_stats = client.teams.get_team_with_stats(id=7)
buffalo_with_stats

buffalo_roster = client.teams.get_team_roster(id=7)
buffalo_roster

buffalo_full_team_stats = client.teams.get_team_stats(id=7)
buffalo_full_team_stats

Standing APIs

# These can be used in conjunction with get_standings_by_standing_type
all_standing_types = client.standings.get_standing_types()
all_standing_types

# standings by season
all_standings = client.standings.get_standings(season="20222023", detailed_record=False)
all_standings

# same as above but with more detailed information
# standings by season
all_standings = client.standings.get_standings(season="20222023", detailed_record=True)
all_standings

# Get standings by type, types can be found via get_standings_by_type, or in the docstring
post_season = client.standings.get_standings_by_standing_type(standing_type="regularSeason")
post_season

Players

# APIs to access player information.  Requires person_id, found from `teams.get_team_roster()`
jj = client.players.get_player(person_id=8482175)
jj

jj_stats = client.players.get_player_stats(person_id=8482175, season="20222023", stat_type="statsSingleSeason")
jj_stats

# Differnt stat types you can access
types = client.players.get_player_stat_types()
types

---

Developers

poetry install --with dev