# NHL Scores, Standings, Teams & Rosters Scraper (`scrapers_lat/nhl-scores-standings-scraper`) Actor

Scrape NHL game scores by date, conference and division standings, all 32 teams and full rosters. Get matchups, scores, points, streaks, top scorers, odds, box scores and player bios. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/nhl-scores-standings-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.56 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![NHL Scores, Standings, Teams & Rosters Scraper](https://scrapers.lat/banners/nhl-scores-standings-scraper.png)](https://console.apify.com/actors/dRT2HeaG2ewRQNFvy/input)

## NHL Scores, Standings, Teams & Rosters Scraper

Here is one real result, with every field the actor returns (a completed game with the box score and AI matchup add-ons switched on):

```json
{
  "recordType": "game",
  "gameId": "401803558",
  "season": "2025-26",
  "seasonYear": 2026,
  "seasonType": "Regular Season",
  "date": "2026-04-04T16:30Z",
  "name": "Detroit Red Wings at New York Rangers",
  "shortName": "DET @ NYR",
  "state": "post",
  "status": "Final",
  "statusDetail": "Final",
  "completed": true,
  "period": 3,
  "clock": "0:00",
  "homeTeam": "New York Rangers",
  "homeAbbrev": "NYR",
  "homeTeamId": "13",
  "homeScore": 4,
  "homeWinner": true,
  "homeRecord": "32-36-9",
  "homeLogo": "https://a.espncdn.com/i/teamlogos/nhl/500/scoreboard/nyr.png",
  "homeTopPerformer": "Gabe Perreault",
  "homeTopPerformerLine": "3",
  "homeGoalsLeader": "Gabe Perreault",
  "homeGoalsLeaderValue": 3,
  "homeAssistsLeader": "Adam Fox",
  "homeAssistsLeaderValue": 2,
  "homePointsLeader": "Gabe Perreault",
  "homePointsLeaderValue": 3,
  "awayTeam": "Detroit Red Wings",
  "awayAbbrev": "DET",
  "awayTeamId": "5",
  "awayScore": 1,
  "awayWinner": false,
  "awayRecord": "40-28-8",
  "awayTopPerformer": "David Perron",
  "awayTopPerformerLine": "1",
  "awayGoalsLeader": "David Perron",
  "awayGoalsLeaderValue": 1,
  "awayAssistsLeader": "Emmitt Finnie",
  "awayAssistsLeaderValue": 1,
  "awayPointsLeader": "David Perron",
  "awayPointsLeaderValue": 1,
  "venue": "Madison Square Garden",
  "venueCity": "New York",
  "venueState": "NY",
  "attendance": 17292,
  "broadcast": "ABC",
  "url": "https://www.espn.com/nhl/game/_/gameId/401803558/red-wings-rangers",
  "aiStoryline": "The New York Rangers secured a decisive victory over the Detroit Red Wings, showcasing their offensive prowess with Gabe Perreault leading the charge.",
  "aiKeyPlayers": "Gabe Perreault, David Perron",
  "aiPrediction": "The Rangers' win highlights their potential to finish the season strong, while the Red Wings must regroup to maintain their playoff positioning.",
  "homeShots": 20,
  "homeHits": 23,
  "homeBlockedShots": 17,
  "homePowerPlayGoals": 1,
  "homePowerPlayOpportunities": 2,
  "homePowerPlayPct": 50,
  "homeFaceoffsWon": 34,
  "homeFaceoffWinPct": 60.7,
  "homePenaltyMinutes": 13,
  "awayShots": 33,
  "awayHits": 14,
  "awayBlockedShots": 15,
  "awayFaceoffsWon": 22,
  "awayFaceoffWinPct": 39.3,
  "awayPenaltyMinutes": 9,
  "observedAt": "2026-08-21T06:25:52.621Z",
  "error": null
}
```

The most complete NHL scraper available. It returns every field the public NHL data feed exposes for scores, standings, teams and rosters, plus derived fields such as per-team goals, assists and points leaders, home and away box score splits, and an optional AI matchup summary, and gives you four modes with team and date filters to target exactly the records you need.

**📥 [Input](https://apify.com/scrapers_lat/nhl-scores-standings-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/nhl-scores-standings-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/nhl-scores-standings-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/nhl-scores-standings-scraper/examples)**

![Platform](https://img.shields.io/badge/platform-Apify-blue) ![Coverage](https://img.shields.io/badge/coverage-NHL%2032%20teams-orange) ![Output](https://img.shields.io/badge/output-JSON%20%7C%20CSV%20%7C%20Excel-green) ![Billing](https://img.shields.io/badge/billing-pay%20per%20result-purple)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)
- [More scrapers at scrapers.lat](#more-scrapers-at-scraperslat)

### What it does

This actor pulls live and historical NHL data in four modes:

- **Scores**: one record per game for any date. Matchup, goals, live status, period and clock, home and away records, venue and attendance, broadcast networks, betting line when posted, and the goals, assists and points leaders for each team. Optional per-game team box score and an optional AI matchup summary.
- **Standings**: one record per team with conference, division, playoff seed, wins, losses, overtime losses, points, points percentage, games behind, current streak, goals for and against, goal differential, and home, away, last ten and division splits.
- **Teams**: one record per team (all 32) with location, nickname, colors, logo, home arena, and current standing summary.
- **Roster**: one record per player for a chosen team with jersey number, position, position group, height, weight, age, birthplace, years of experience, and headshot.

It is built for NHL fans, sports betting and fantasy hockey tools, media sites, and app developers who need clean, structured NHL data without maintaining a scraper.

### Quickstart

Get the current standings. Free Apify plans return up to 10 records per run.

```json
{
  "mode": "standings",
  "maxResults": 32
}
```

Games for a specific date:

```json
{
  "mode": "scores",
  "date": "2026-04-04",
  "maxResults": 20
}
```

A team roster:

```json
{
  "mode": "roster",
  "teamAbbrev": "EDM",
  "maxResults": 30
}
```

### Input reference

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `mode` | string | no | What to scrape: `scores`, `standings`, `teams` or `roster`. Default `standings`. | `"standings"` |
| `date` | string | no | Scores mode only. Single day in YYYY-MM-DD. Empty returns today's games and nearby fixtures. | `"2026-04-04"` |
| `season` | integer | no | Season year (for example 2026 for the 2025-26 season). | `2026` |
| `teamAbbrev` | string | no | Roster mode. Team abbreviation such as EDM, TOR, BOS, COL. | `"EDM"` |
| `teamId` | string | no | Roster mode. Numeric team id (alternative to `teamAbbrev`; wins if both set). | `"6"` |
| `includeBoxScore` | boolean | no | Scores mode, paid plans. Add the full team box score per game. Billed only when a real box score is returned. | `true` |
| `aiMatchupSummary` | boolean | no | Scores mode, paid plans. Add an AI storyline, key players and prediction per game. Billed only on usable AI output. | `true` |
| `maxResults` | integer | no | Maximum records to return. Free plans are capped at 10. | `32` |

### Output reference

Field set depends on `mode`. Common and per-mode fields:

| Name | Type | Description |
| --- | --- | --- |
| `recordType` | string | `game`, `standing`, `team` or `player` |
| `gameId` | string | Game id (scores) |
| `date` | string | Game date and time, ISO 8601 (scores) |
| `shortName` | string | Short matchup, e.g. DET @ NYR (scores) |
| `statusDetail` | string | Game status, e.g. Final or 2nd 8:14 (scores) |
| `homeTeam` / `awayTeam` | string | Team names (scores) |
| `homeScore` / `awayScore` | number | Team goals (scores) |
| `homeRecord` / `awayRecord` | string | Season record at game time (scores) |
| `homeTopPerformer` / `awayTopPerformer` | string | Standout player per team (scores) |
| `homeGoalsLeader` / `homeAssistsLeader` / `homePointsLeader` | string | Category leaders per team (scores) |
| `venue` / `venueCity` / `venueState` | string | Arena and location (scores, teams) |
| `broadcast` | string | Broadcast networks (scores) |
| `spread` / `overUnder` / `homeMoneyLine` / `awayMoneyLine` | number | Betting line when posted (scores) |
| `homeShots` / `homeHits` / `homePowerPlayPct` / `homeFaceoffWinPct` | number | Team box score, box score add-on (scores) |
| `aiStoryline` / `aiKeyPlayers` / `aiPrediction` | string | AI matchup summary, AI add-on (scores) |
| `team` / `teamAbbrev` / `teamId` | string | Team identity (standings, teams, roster) |
| `conference` / `division` | string | Conference and division (standings, teams) |
| `playoffSeed` / `gamesPlayed` / `wins` / `losses` / `otLosses` / `points` | number | Standing (standings) |
| `pointsPct` / `goalsFor` / `goalsAgainst` / `goalDifferential` | number | Points percentage and goal splits (standings) |
| `gamesBehind` / `streak` / `record` | string | Games behind, streak, overall record (standings) |
| `homeRecord` / `awayRecord` / `lastTenRecord` / `divisionRecord` | string | Split records (standings) |
| `regulationWins` / `overtimeWins` / `shootoutWins` | number | Win type splits (standings) |
| `location` / `nickname` / `color` / `alternateColor` / `teamLogo` | string | Team identity and branding (teams) |
| `standingSummary` | string | e.g. 1st in Metropolitan Division (teams) |
| `player` / `jersey` / `position` / `positionGroup` | string | Player identity (roster) |
| `height` / `weight` / `age` / `experienceYears` / `shootsCatches` | string, number | Player bio (roster) |
| `birthCity` / `birthState` / `birthCountry` / `headshot` | string | Player origin and photo (roster) |
| `observedAt` | string | When the record was captured, ISO 8601 |
| `error` | string | Error message when a record could not be built, otherwise null |

### Example output record

A standings record:

```json
{
  "recordType": "standing",
  "team": "Carolina Hurricanes",
  "teamAbbrev": "CAR",
  "teamId": "7",
  "conference": "Eastern Conference",
  "division": "Metropolitan Division",
  "playoffSeed": 1,
  "gamesPlayed": 82,
  "wins": 53,
  "losses": 22,
  "otLosses": 7,
  "points": 113,
  "pointsPct": 0.689,
  "streak": "W1",
  "record": "53-22-7, 113 PTS",
  "homeRecord": "29-10-2",
  "lastTenRecord": "7-2-1, 0 PTS",
  "regulationWins": 39,
  "goalsFor": 296,
  "goalsAgainst": 240,
  "goalDifferential": 56,
  "clinchIndicator": "z",
  "observedAt": "2026-08-21T06:25:00.000Z",
  "error": null
}
```

A roster record:

```json
{
  "recordType": "player",
  "player": "Connor McDavid",
  "team": "Edmonton Oilers",
  "teamAbbrev": "EDM",
  "jersey": "97",
  "position": "Center",
  "positionGroup": "Centers",
  "height": "6' 1\"",
  "weight": "194 lbs",
  "age": 29,
  "birthCity": "Richmond Hill",
  "birthCountry": "CAN",
  "experienceYears": 11,
  "headshot": "https://a.espncdn.com/i/headshots/nhl/players/full/3895074.png",
  "observedAt": "2026-08-21T06:25:00.000Z",
  "error": null
}
```

### Run via API and CLI

Start a run with the Apify API:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nhl-scores-standings-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"scores","date":"2026-04-04","maxResults":20}'
```

Run with the Apify CLI:

```bash
apify call scrapers_lat/nhl-scores-standings-scraper \
  --input '{"mode":"standings","maxResults":32}'
```

### Fetch results

Download the dataset items in JSON, CSV or Excel:

```bash
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=csv" -o nhl.csv
```

The run response includes `defaultDatasetId`. Add `&format=json`, `&format=csv` or `&format=xlsx`.

### Billing and limits

- **Pay per result.** You are charged per record returned. Empty runs (for example a date with no games) return nothing and are not charged for results.
- **Events.** `apify-actor-start` (one-time per run), `result` (one game, standing, team or player), plus optional `game_boxscore` (per-game team box score) and `ai_matchup_summary` (per-game AI summary). Add-ons are opt-in, off by default, and available on paid plans only.
- **No charge on failure.** A record is only billed when real data is produced. Box score and AI events are billed only when they actually return content.
- **Free plan cap.** Free Apify accounts return up to 10 records per run. Paid accounts can raise `maxResults`.
- **Spend cap.** The actor respects your run `maxTotalChargeUsd` and stops emitting billable records once the limit is reached.

### FAQ and troubleshooting

**No records came back for my date.** That date had no scheduled games. Try a date during the season, for example a regular season or playoff day.

**Which team abbreviations work?** Standard NHL abbreviations such as EDM, TOR, BOS, COL, NYR, VGK. You can also pass a numeric `teamId`.

**Are betting lines always included?** The puck line, over/under and moneyline are included when a sportsbook line is posted for a game, otherwise they are null.

**What is in the box score add-on?** Shots on goal, hits, blocked shots, takeaways, giveaways, power play goals and percentage, faceoffs won and win percent, and penalty minutes for each team.

**How fresh is the data?** Scores reflect live game state including the current period and clock. Standings and rosters reflect the current season.

### More scrapers at scrapers.lat

Building sports and data products? Explore more actors from scrapers\_lat on Apify for scores, standings, odds and structured public data across sports, finance and business.

***

This actor is an independent tool that collects publicly available information. It is not affiliated with, endorsed by, or sponsored by the NHL or any team or data provider.

# Actor input Schema

## `mode` (type: `string`):

Choose the kind of NHL data to collect: game scores for a date, the league standings, the list of teams, or a team's roster.

## `date` (type: `string`):

Scores mode only. A single day in YYYY-MM-DD format (for example 2026-04-04). Leave empty to return today's games and nearby fixtures.

## `season` (type: `integer`):

Optional NHL season year (for example 2026 for the 2025-26 season). Applied where the source supports it; standings and scores reflect the current season by default.

## `teamAbbrev` (type: `string`):

Roster mode only. Team abbreviation such as EDM, TOR, BOS, COL. Used to select which team's players to return.

## `teamId` (type: `string`):

Roster mode only. Numeric team ID (alternative to Team abbreviation). If both are set, Team ID wins.

## `includeBoxScore` (type: `boolean`):

Scores mode only, paid plans only. Fetch the full team box score for each game (shots, hits, blocked shots, power play, faceoffs, penalty minutes). Billed per game only when a real box score is returned.

## `aiMatchupSummary` (type: `boolean`):

Scores mode only, paid plans only. Add an AI-written storyline, key players and prediction for each game. Billed per game only when usable AI output is produced.

## `maxResults` (type: `integer`):

Maximum number of records to collect (games, standings rows, teams or players). Free Apify plans are capped at 10 per run.

## Actor input object example

```json
{
  "mode": "standings",
  "teamAbbrev": "EDM",
  "includeBoxScore": false,
  "aiMatchupSummary": false,
  "maxResults": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "standings",
    "teamAbbrev": "EDM",
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/nhl-scores-standings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "standings",
    "teamAbbrev": "EDM",
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/nhl-scores-standings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "standings",
  "teamAbbrev": "EDM",
  "maxResults": 10
}' |
apify call scrapers_lat/nhl-scores-standings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/nhl-scores-standings-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dRT2HeaG2ewRQNFvy/builds/b0lgfAExJ76K1qcGJ/openapi.json