NHL APInhl.com ↗
Access NHL game schedules, live scores, standings, team rosters, player profiles, boxscores, and projected lineups via a structured JSON API.
What is the NHL API?
This API exposes 9 endpoints covering NHL game data from nhl.com, including live scores, standings, and detailed boxscores. The get_scores endpoint returns goals, shots on goal, and broadcast info for any date. The get_gamecenter_boxscore endpoint breaks down individual player stats — goals, assists, time on ice, shots — for both teams in a given game. Player data is accessible by NHL player ID via get_player_landing, which includes career totals and current season stats.
curl -X GET 'https://api.parse.bot/scraper/60cc76ee-6406-499c-84fa-a80b0250c465/get_schedule?date=now' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nhl-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""NHL API - Walkthrough: search players, get standings, check boxscores."""
from parse_apis.nhl_api import NHL, TeamAbbrev, ResourceNotFound
client = NHL()
# List all teams and show first few
for team in client.teams.list(limit=5):
print(team.name, team.division, team.conference)
# Search for a player by name, take the first result
result = client.playersummaries.search(query="mcdavid", limit=1).first()
if result:
print(result.name, result.team_abbrev, result.position_code)
# Drill into player details from the search result
if result:
player = result.details()
print(player.first_name, player.last_name, player.position)
if player.career_totals:
print(player.career_totals.goals, player.career_totals.assists, player.career_totals.points)
# Get team roster using constructible Team with enum
edm = client.team(abbrev=TeamAbbrev.EDM)
roster = edm.roster()
for fwd in roster.forwards[:3]:
print(fwd.first_name, fwd.last_name, fwd.position_code)
# Get schedule as a single object and inspect its game_week
schedule = client.schedules.get(date="2025-01-15")
for day in schedule.game_week[:2]:
print(day.date, day.number_of_games)
# Typed error handling: catch a not-found player
try:
client.players.get(player_id="0000000")
except ResourceNotFound as exc:
print(f"Player not found: {exc}")
print("exercised: teams.list / playersummaries.search / details / team.roster / schedules.get / players.get")
Fetch the full NHL game schedule for a given date. Returns a week of games centered around the requested date, including game details, broadcast info, and scores for completed games. The gameWeek array contains one entry per day with that day's games.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format, or 'now' for current schedule. |
{
"type": "object",
"fields": {
"gameWeek": "array of day objects each containing date, dayAbbrev, numberOfGames, and games array",
"nextStartDate": "string, next week start date in YYYY-MM-DD format",
"previousStartDate": "string, previous week start date in YYYY-MM-DD format"
}
}About the NHL API
Schedule, Scores, and Standings
The get_schedule endpoint accepts a date in YYYY-MM-DD format (or 'now' for the current week) and returns a gameWeek array covering seven days of games, with matchup details, broadcast info, and scores for completed contests. The response also includes nextStartDate and previousStartDate for easy pagination through weeks. The get_scores endpoint focuses on a single date, returning each game's current score, goal scorers, shots on goal, and broadcast channels alongside nextDate and prevDate pointers. get_standings returns every team's points, wins, losses, division, and conference and supports historical queries by passing a specific date.
Team and Player Data
The get_team_roster endpoint takes a team abbreviation (e.g., EDM, TOR, NYR) and an optional season string (e.g., 20242025) and returns three arrays: forwards, defensemen, and goalies, each with player ID, name, position, and sweater number. get_player_landing accepts a numeric NHL player ID and returns a full profile: firstName, lastName, position, currentTeamAbbrev, careerTotals split into regular season and playoffs, and featuredStats for the current season. Player IDs can be discovered using search_players, which accepts a name query and returns matching active players with their playerId, teamAbbrev, and positionCode.
Boxscores and Lineups
The get_gamecenter_boxscore endpoint accepts a game_id (obtainable from schedule or scores responses) and returns homeTeam and awayTeam objects with score and shots on goal, plus a playerByGameStats object containing per-player stat lines — goals, assists, TOI, shots — organized into forwards, defense, and goalies for each side. The gameState field indicates whether a game is final (OFF), live (LIVE), or upcoming (FUT). The get_projected_lineups endpoint returns a paginated list of news articles from nhl.com tagged to lineup and game-day content, each with a headline, summary, slug, and tags.
Team Metadata
The get_team_info_all endpoint requires no inputs and returns a complete list of all NHL franchises with each team's name, abbrev, division, conference, and a logo URL pointing to the team's SVG. This is useful for populating dropdowns or enriching data from other endpoints with display-ready team metadata.
The NHL API is a managed, monitored endpoint for nhl.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nhl.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nhl.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display live NHL scores and goal scorers in a sports dashboard by polling
get_scoreswith'now'. - Build a standings tracker that shows division and conference rankings with wins, losses, and points from
get_standings. - Generate player profile pages using
get_player_landingwith career totals, current season stats, and team affiliation. - Look up a player's ID by name with
search_playersbefore querying detailed stats viaget_player_landing. - Pull full game boxscores including per-player TOI and shot counts using
get_gamecenter_boxscorefor post-game analysis. - Retrieve historical team rosters for a specific season using
get_team_rosterwith theseasonparameter. - Populate a team directory with logos, divisions, and conference assignments from
get_team_info_all.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NHL.com have an official developer API?+
What does `get_gamecenter_boxscore` return for in-progress games?+
gameState field will be LIVE for in-progress games, and playerByGameStats will reflect stats accumulated up to that point in the game. Final games return gameState as OFF. Future games return FUT with no player stat lines.How do I find a player's NHL ID to use with `get_player_landing`?+
search_players endpoint with a name query (e.g., mcdavid or ovechkin). It returns playerId, teamAbbrev, and positionCode for matching active players. Pass the playerId directly to get_player_landing.