Skip to main content
Version: 0.0.56

NHL — ESPN site API (v2)

sportsdataverse.nhl — 24 endpoints.

espn_nhl_scoreboard

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/scoreboard

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/scoreboard?dates=20240115

API ParameterPythonPatternRequiredNullableDescription
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
weekweekYWeek number within the season (football).
seasontypeseason_typeYSeason phase: 1=preseason, 2=regular season, 3=postseason.
groupsgroupsYConference or group id filter (e.g. an ESPN conference id).
limitlimitYMaximum number of items to return.

Returns

col_nametypedescription
game_idcharacterESPN event id.
uidcharacterCompetitor uid string.
datecharacterGame date (ISO 8601 datetime string).
namecharacterTeam mascot name.
short_namecharacterShort game name.
season_yearintegerSeason end year.
season_typeintegerSeason type code (echoed from arg).
season_slugcharacterSeason type slug.
status_type_idcharacterStatus type identifier.
status_type_namecharacterStatus type name.
status_type_statecharacterStatus state (pre/in/post).
status_type_completedlogicalWhether the game is complete.
status_type_descriptioncharacterStatus description.
status_type_detailcharacterStatus detail text.
status_type_short_detailcharacterShort status detail.
status_clockdoubleGame clock in seconds.
status_display_clockcharacterDisplay clock string.
status_periodintegerCurrent period.
neutral_sitelogicalWhether the game is at a neutral site.
conference_competitioncharacterWhether it is a conference competition.
attendanceintegerGame attendance.
venue_idcharacterVenue identifier.
venue_full_namecharacterVenue full name.
venue_citycharacterVenue city.
venue_statecharacterVenue state.
venue_indoorlogicalWhether the venue is indoors.
broadcastcharacterBroadcast network(s).
notecharacterGame note or headline.
home_idcharacterHome team ESPN identifier.
home_namecharacterHome team display name.
home_abbreviationcharacterHome team abbreviation.
home_display_namecharacterHome team display name.
home_locationcharacterHome team city.
home_colorcharacterHome team primary color hex.
home_alternate_colorcharacterHome team alternate color hex.
home_logocharacterHome team logo URL.
home_scorecharacterHome team final score.
home_winnerlogicalWhether the home team won.
home_rankintegerHome team rank (if ranked).
away_idcharacterAway team ESPN identifier.
away_namecharacterAway team display name.
away_abbreviationcharacterAway team abbreviation.
away_display_namecharacterAway team display name.
away_locationcharacterAway team city.
away_colorcharacterAway team primary color hex.
away_alternate_colorcharacterAway team alternate color hex.
away_logocharacterAway team logo URL.
away_scorecharacterAway team final score.
away_winnerlogicalWhether the away team won.
away_rankintegerAway team rank (if ranked).

Example

espn_nhl_scoreboard(dates='20240115')

Last validated n/a.

espn_nhl_summary

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/summary

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/summary

API ParameterPythonPatternRequiredNullableDescription
eventevent_idYevent query parameter.

Returns

boxscore_player

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_locationcharacterTeam location.
athlete_idcharacterAthlete id.
athlete_display_namecharacterAthlete display name.
athlete_short_namecharacterAthlete short name.
athlete_jerseycharacterAthlete jersey.
athlete_positioncharacterAthlete position.
startercharacterStarter.
activecharacterActive.
did_not_playcharacterDid not play.
ejectedcharacterEjected.
reasoncharacterReason.
blocked_shotscharacterBlocked shots.
hitscharacterHits.
takeawayscharacterTakeaways.
plus_minuscharacterPlus minus.
time_on_icecharacterTime on ice in seconds.
power_play_time_on_icecharacter
short_handed_time_on_icecharacter
even_strength_time_on_icecharacter
shiftscharacterNumber of shifts.
goalscharacterGoals scored.
ytd_goalscharacter
assistscharacterAssists.
shots_totalcharacterShots on goal.
shots_missedcharacter
shootout_goalscharacterShootout goals.
faceoffs_woncharacterFaceoffs won in the season.
faceoffs_lostcharacterFaceoffs lost in the season.
faceoff_percentcharacterFaceoff win percentage.
giveawayscharacterGiveaways.
penaltiescharacterPenalty count.
penalty_minutescharacterPenalty minutes.
goals_againstcharacterGoals against.
shots_againstcharacterShots faced.
shootout_savescharacterShootout saves made.
shootout_shots_againstcharacter
savescharacterSaves made.
save_pctcharacterSave percentage.
even_strength_savescharacter
power_play_savescharacter
short_handed_savescharacter

boxscore_team

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
home_awaycharacterHome away.
display_orderintegerDisplay order.
stat_namecharacterStat name.
stat_labelcharacterStat label.
stat_display_valuecharacterStat display value.
stat_valuecharacterStat value.

plays

col_nametypedescription
idcharacterId.
sequence_numbercharacterSequence number.
textcharacterText.
away_scoreintegerAway score.
home_scoreintegerHome score.
scoring_playlogicalScoring play.
score_valueintegerScore value.
modifiedcharacterISO timestamp the play record was last modified.
wallclockcharacterWallclock.
shooting_playlogicalShooting play.
type_idcharacterType id.
type_textcharacterType text.
type_abbreviationcharacterPlay type abbreviation.
period_numberintegerPeriod number.
period_display_valuecharacterPeriod display value.
clock_display_valuecharacterClock display value.
participantscharacterParticipants.
team_idcharacterTeam id.
strength_idcharacterStrength situation id (e.g. even strength, PP, SH).
strength_textcharacterStrength situation (e.g. "Even Strength", "Power Play").
strength_abbreviationcharacter
coordinate_xdoubleCoordinate x.
coordinate_ydoubleCoordinate y.
shot_info_idcharacterShot type identifier.
shot_info_textcharacterShot type text (e.g. "Wrist Shot").
shot_info_abbreviationcharacter

leaders

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
category_namecharacterCategory name.
category_display_namecharacterCategory display name.
athlete_idcharacterAthlete id.
athlete_display_namecharacterAthlete display name.
athlete_positioncharacterAthlete position.
valuedoubleValue.
display_valuecharacterDisplay value.
main_statcharacterMain stat.
summarycharacterSummary.

game_info

col_nametypedescription
attendanceintegerAttendance.
venue_idcharacterVenue id.
venue_guidcharacterVenue guid.
venue_full_namecharacterVenue full name.
venue_address_citycharacterVenue address city.
venue_address_statecharacterVenue address state.
venue_address_countrycharacter
venue_grasslogicalVenue grass.

officials

col_nametypedescription
full_namecharacterFull name.
display_namecharacterDisplay name.
orderintegerOrder.
position_namecharacterPosition name.
position_display_namecharacterPosition display name.
position_idcharacterPosition id.

header

col_nametypedescription
idcharacterId.
uidcharacterUid.
time_validlogicalTime valid.
competitionscharacterCompetitions.
linkscharacterLinks.
game_notecharacter
standingscharacter
season_yearintegerSeason year.
season_currentlogicalSeason current.
season_typeintegerSeason type.
league_idcharacterLeague id.
league_uidcharacterLeague uid.
league_namecharacterLeague name.
league_abbreviationcharacterLeague abbreviation.
league_slugcharacterLeague slug.
league_is_tournamentlogicalLeague is tournament.
league_linkscharacterLeague links.
league_logoscharacterLeague logos.

season_series

col_nametypedescription
typecharacterType.
titlecharacterTitle.
descriptioncharacterDescription.
summarycharacterSummary.
completedlogicalCompleted.
total_competitionsintegerTotal competitions.
series_labelcharacterSeries label.
series_scorecharacterSeries score.
short_summarycharacterShort summary.
eventscharacterEvents.
roundcharacterShootout round number.

standings

col_nametypedescription
group_headercharacterGroup header.
conference_headercharacterConference header.
division_headercharacterDivision header.
team_idcharacterTeam id.
team_uidcharacterTeam uid.
team_locationcharacterTeam location.
ot_lossescharacterOvertime losses.
lossescharacterLosses.
pointscharacterPoints.
winscharacterWins.

broadcasts

col_nametypedescription
stationcharacterStation full name (e.g. "FanDuel Sports Network Detroit").
langcharacterBroadcast language (e.g. "en").
regioncharacterBroadcast region (e.g. "us").
is_nationallogical
type_idcharacterType id.
type_short_namecharacterBroadcast type short name (e.g. "TV").
type_long_namecharacterBroadcast type long name (e.g. "Television").
type_slugcharacterBroadcast type slug.
market_idcharacterMarket identifier.
market_typecharacterMarket type.
media_call_letterscharacterMedia outlet call letters.
media_namecharacterMedia outlet full name.
media_short_namecharacterMedia outlet short name.

format

col_nametypedescription
regulation_periodsintegerRegulation periods.
regulation_display_namecharacterRegulation display name.
regulation_slugcharacterRegulation slug.
regulation_clockdoubleRegulation clock.

article

col_nametypedescription
idintegerId.
now_idcharacterNow id.
content_keycharacterContent key.
data_source_identifiercharacterData source identifier.
publishedkeycharacterPublishedkey.
typecharacterType.
game_idcharacterGame id.
headlinecharacterHeadline.
descriptioncharacterDescription.
link_textcharacterLink text.
categorizedcharacterCategorized.
originally_postedcharacterOriginally posted.
last_modifiedcharacterLast modified.
publishedcharacterPublished.
sectioncharacterSection.
sourcecharacterSource.
imagescharacterImages.
videocharacterVideo.
categoriescharacterCategories.
keywordscharacterKeywords.
storycharacterStory.
premiumlogicalPremium.
is_live_bloglogicalIs live blog.
allow_commentslogicalAllow comments.
allow_searchlogicalAllow search.
allow_content_reactionslogicalAllow content reactions.
links_web_hrefcharacterLinks web href.
links_mobile_hrefcharacterLinks mobile href.
links_api_self_hrefcharacterLinks api self href.
links_app_sportscenter_hrefcharacterLinks app sportscenter href.

injuries

col_nametypedescription
injuriescharacterInjuries.
team_idcharacterTeam id.
team_uidcharacterTeam uid.
team_display_namecharacterTeam display name.
team_abbreviationcharacterTeam abbreviation.
team_linkscharacterTeam links.
team_logocharacterTeam logo.
team_logoscharacterTeam logos.

news

col_nametypedescription
idintegerId.
now_idcharacterNow id.
content_keycharacterContent key.
data_source_identifiercharacterData source identifier.
typecharacterType.
headlinecharacterHeadline.
descriptioncharacterDescription.
last_modifiedcharacterLast modified.
publishedcharacterPublished.
imagescharacterImages.
categoriescharacterCategories.
premiumlogicalPremium.
bylinecharacterByline.
links_web_hrefcharacterLinks web href.
links_mobile_hrefcharacterLinks mobile href.
links_api_self_hrefcharacterLinks api self href.
links_app_sportscenter_hrefcharacterLinks app sportscenter href.

Example

espn_nhl_summary()

Last validated n/a.

espn_nhl_calendar

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/calendar

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/calendar

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_calendar()

Last validated n/a.

espn_nhl_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/news

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_news()

Last validated n/a.

espn_nhl_injuries

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/injuries

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_injuries()

Last validated n/a.

espn_nhl_transactions

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/transactions

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_transactions()

Last validated n/a.

espn_nhl_conferences

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/groups

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/groups

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_conferences()

Last validated n/a.

espn_nhl_statistics_league

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/statistics

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/statistics

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_statistics_league()

Last validated n/a.

espn_nhl_draft

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/draft

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/draft

API ParameterPythonPatternRequiredNullableDescription

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_draft()

Last validated n/a.

espn_nhl_teams_site

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns

col_nametypedescription
team_abbreviationcharacterShort team abbreviation (e.g. "BOS").
team_alternate_colorcharacterSecondary team color as a hex string (no leading '#').
team_colorcharacterPrimary team color as a hex string (no leading '#').
team_display_namecharacterFull team display name (location + nickname).
team_idcharacterESPN team id (stable join key across ESPN endpoints).
team_is_activelogicalWhether the team is currently active.
team_is_all_starlogicalWhether the entry is an all-star squad rather than a franchise.
team_locationcharacterTeam location / city (e.g. "Boston").
team_logoscharacterPipe-delimited logo image URLs.
team_namecharacterTeam nickname/mascot (e.g. "Celtics").
team_nicknamecharacterTeam nickname as ESPN labels it (often equals team_name).
team_short_display_namecharacterAbbreviated display name for compact UIs.
team_slugcharacterURL slug used in ESPN web paths.
team_uidcharacterESPN global UID (encodes sport/league/team).

Example

espn_nhl_teams_site()

Last validated n/a.

espn_nhl_team

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team(team_id='4')

Last validated n/a.

espn_nhl_team_roster

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/roster

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/roster

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

col_nametypedescription
position_groupcharacterPosition group name (e.g. Centers).
idcharacterId.
uidcharacterUid.
guidcharacterGuid.
alternate_idcharacterAlternate player identifier.
first_namecharacterFirst name.
last_namecharacterLast name.
full_namecharacterFull name.
display_namecharacterDisplay name.
short_namecharacterShort name.
weightdoubleWeight.
display_weightcharacterDisplay weight.
heightdoubleHeight.
display_heightcharacterDisplay height.
ageintegerAge.
date_of_birthcharacterDate of birth.
linkscharacterLinks.
slugcharacterSlug.
jerseycharacterJersey.
injuriescharacterInjuries.
teamscharacterTeams.
contractscharacterContracts.
alternate_ids_sdrcharacterAlternate ids sdr.
birth_place_citycharacterBirth place city.
birth_place_countrycharacterBirth place country.
birth_place_display_textcharacterBirth place display text.
birth_country_abbreviationcharacterBirth country abbreviation.
headshot_hrefcharacterHeadshot href.
headshot_altcharacterHeadshot alt.
hand_typecharacterHand type.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.
position_idcharacterPosition id.
position_namecharacterPosition name.
position_display_namecharacterPosition display name.
position_abbreviationcharacterPosition abbreviation.
position_leaflogicalPosition leaf.
position_parent_idcharacterParent position identifier.
position_parent_namecharacterParent position name.
position_parent_display_namecharacterParent position display name.
position_parent_abbreviationcharacterParent position abbreviation.
position_parent_leaflogicalWhether parent position is leaf.
experience_yearsintegerExperience years.
status_idcharacterStatus id.
status_namecharacterStatus name.
status_typecharacterStatus type.
status_abbreviationcharacterStatus abbreviation.
debut_yeardoubleDebut year.
college_idcharacterCollege id.
college_guidcharacterCollege guid.
college_mascotcharacterCollege mascot.
college_namecharacterCollege name.
college_short_namecharacterCollege short name.
college_abbrevcharacterCollege abbrev.
college_logoscharacterCollege logos.
birth_place_statecharacterBirth place state.

Example

espn_nhl_team_roster(team_id='4')

Last validated n/a.

espn_nhl_team_schedule

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/schedule

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/schedule

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYSeason year (e.g. 2024).

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_schedule(team_id='4')

Last validated n/a.

espn_nhl_team_record

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/record

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/record

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_record(team_id='4')

Last validated n/a.

espn_nhl_team_depthcharts

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/depthcharts

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/depthcharts

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_depthcharts(team_id='4')

Last validated n/a.

espn_nhl_team_injuries

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/injuries

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_injuries(team_id='4')

Last validated n/a.

espn_nhl_team_transactions

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/transactions

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_transactions(team_id='4')

Last validated n/a.

espn_nhl_team_history

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/history

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/history

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_history(team_id='4')

Last validated n/a.

espn_nhl_team_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/news

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
limitlimitYMaximum number of items to return.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_news(team_id='4')

Last validated n/a.

espn_nhl_team_leaders

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/{team_id}/leaders

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/4/leaders

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_team_leaders(team_id='4')

Last validated n/a.

espn_nhl_player_info

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/{athlete_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/4239

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_player_info(athlete_id='4239')

Last validated n/a.

espn_nhl_player_bio

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/{athlete_id}/bio

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/4239/bio

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_player_bio(athlete_id='4239')

Last validated n/a.

espn_nhl_player_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/{athlete_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/hockey/nhl/athletes/4239/news

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_nhl_player_news(athlete_id='4239')

Last validated n/a.

espn_nhl_standings

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/hockey/nhl/standings

Valid URL: https://site.api.espn.com/apis/v2/sports/hockey/nhl/standings

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
groupgroupYConference or group id filter (e.g. an ESPN conference id).
typestandings_typeYStandings variant (e.g. 'by-division' or 'by-conference').

Returns

col_nametypedescription
group_namecharacterGroup name.
group_abbreviationcharacterGroup abbreviation.
team_idcharacterTeam id.
team_namecharacterTeam name.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_locationcharacterTeam location.
team_logocharacterTeam logo.
ot_lossesdoubleOvertime losses.
clincherdoubleClincher.
differentialdoubleDifferential.
games_behinddoubleGames behind.
games_playeddoubleGames played.
lossesdoubleLosses.
playoff_seeddoublePlayoff seed.
point_differentialdoublePoint differential.
pointsdoublePoints.
points_againstdoublePoints against.
points_fordoublePoints for.
streakdoubleStreak.
winsdoubleWins.
overtime_lossesdoubleTotal overtime losses.
overtime_winsdoubleOvertime wins.
points_diffdouble
reg_lossesdouble
reg_winsdouble
rot_lossesdouble
rot_winsdouble
shootout_lossesdoubleShootout losses.
shootout_winsdoubleShootout wins.
overallcharacterOverall.
homecharacterHome.
roadcharacterRoad.
last ten gamescharacterLast ten games.
vs. div.characterVs. div..

Example

espn_nhl_standings()

Last validated n/a.