NHL Data Scraper — Apify Actor

Comprehensive NHL data aggregation from official league APIs and selected secondary sources.

Features

• Standings — season-by-season division/conference/league standings
• Schedule & Scores — league and per-team schedules, daily scores
• Rosters — current and historical team rosters by season
• Player Stats — player landing info, season stat leaders, game-by-game logs
• Team Stats — per-season team statistics (power play, PK, faceoffs, shots)
• Game Data — full boxscores and play-by-play with on-ice coordinates
• Playoffs — bracket, series carousel, series schedules
• Draft — prospect rankings and draft picks by round
• EDGE Tracking — advanced on-ice metrics (shot speed, skating speed, zone time)
• Team Logos — CDN URLs for light/dark logos by season range
• Coaching Records (opt-in) — career coaching history via Hockey-Reference
• Advanced Stats (opt-in) — xG, Corsi, SRS, 5-on-5 analytics via Hockey-Reference
• Transactions (opt-in) — player transaction history
• Salary Data (opt-in) — team cap sheets, contracts, signings via PuckPedia
• Trades (opt-in) — trade tracker with players, picks, cap retention

Input

See input_schema.json for the full schema. Key fields:

Field	Type	Required	Description
seasons	string[]	Yes	NHL seasons (e.g. ["20242025"])
teams	string[]	No	Team abbreviations (empty = all 32)
players	integer[]	No	Player IDs for targeted stats
endpoints	string[]	No	Data types to fetch
riskySources	boolean	No	Enable Hockey-Reference / PuckPedia scrapers (opt-in, use at your own risk)

Output

Results are stored in the default dataset. Each item has:

• dataType — type of record
• season — NHL season identifier
• source — data source
• fetchedAt — ISO timestamp
• data — the payload (schema varies by dataType)

Pricing (Pay-per-event)

Event	Price	Trigger
Actor start	$0.05/1k	Automatic at run start
Dataset item	Per result	Automatic per push
Advanced stat	~$0.01	EDGE/xG enrichment
Logo pack	~$0.005	Per-team logo history
Risky source record	~$0.01	Coach/salary/trade record

API Usage

Synchronous (≤5 min runs)

POST https://api.apify.com/v2/acts/YOUR_USERNAME/nhl-data-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN
Content-Type: application/json

{"seasons": ["20242025"], "endpoints": ["standings", "rosters"]}

Asynchronous

$POST https://api.apify.com/v2/acts/YOUR_USERNAME/nhl-data-scraper/runs?token=YOUR_API_TOKEN

Python client

from apify_client import ApifyClient
client = ApifyClient('YOUR_API_TOKEN')
run = client.actor('YOUR_USERNAME/nhl-data-scraper').call(run_input={
    'seasons': ['20242025'],
    'endpoints': ['standings', 'playerStats'],
})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['dataType'], item['season'])

Sources

• NHL Web API (api-web.nhle.com) — primary source, no auth required
• NHL Stats REST API (api.nhle.com/stats/rest) — league-wide stats
• NHL CDN (assets.nhle.com/logos/nhl/svg) — team logo SVGs
• Hockey-Reference (opt-in, risky) — coaches, advanced stats, transactions
• PuckPedia (opt-in, risky) — salary cap, contracts, trades

Legal Notice

Data from the official NHL APIs is publicly available and free to use. Logo URLs point to NHL's public CDN (logos are NHL trademarks). Hockey-Reference and PuckPedia prohibit automated scraping in their Terms of Service — use the riskySources option at your own risk.

Development

pip install -r requirements.txt
apify run

MCP Support

This actor exposes an MCP endpoint at /mcp for AI agent discovery and payments (x402/Skyfire compatible).