nhl.com APInhl.com ↗
Access NHL game schedules, live scores, standings, team rosters, player profiles, boxscores, and projected lineups via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/60cc76ee-6406-499c-84fa-a80b0250c465/get_schedule?date=2025-01-15' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| 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, games array with matchup details",
"nextStartDate": "string, next week start date in YYYY-MM-DD format",
"previousStartDate": "string, previous week start date in YYYY-MM-DD format"
},
"sample": {
"data": {
"gameWeek": [
{
"date": "2025-01-15",
"games": [
{
"id": 2024020705,
"season": 20242025,
"awayTeam": {
"score": 2,
"abbrev": "CAR"
},
"gameType": 2,
"homeTeam": {
"score": 4,
"abbrev": "BUF"
},
"gameState": "OFF"
}
],
"dayAbbrev": "WED",
"numberOfGames": 2
}
],
"nextStartDate": "2025-01-22",
"previousStartDate": "2025-01-08"
},
"status": "success"
}
}About the nhl.com 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.
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.
- 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 | 250 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.