NHL API Data Scraper

🏒 What It Does

Extracts real-time NHL hockey data from the official NHL public API (api-web.nhle.com). Get league standings, game schedules, team rosters, and detailed player statistics — all without any API key.

📊 Data Modes

Mode	Description	Output
Standings	Current or historical league standings	Team records, points, goals, rankings
Schedule	Game schedule for any date	Game times, scores, venues, broadcasts
Roster	Team roster with player details	Player names, positions, physical stats
Player Stats	Individual player statistics	Season stats, career totals, bio info

🚀 How to Use

1. Select a mode — Choose what type of data you want to extract
2. Configure parameters — Set team abbreviation, player IDs, or date as needed
3. Run the Actor — Click "Start" and wait for results
4. Download data — Export as JSON, CSV, or Excel from the dataset

Input Examples

Get current standings:

{
    "mode": "standings"
}

Get games for a specific date:

{
    "mode": "schedule",
    "date": "2026-03-15"
}

Get a team's roster:

{
    "mode": "roster",
    "team_abbrev": "EDM"
}

Get player stats for specific players:

{
    "mode": "player_stats",
    "player_ids": "8478402,8479318,8477492"
}

📋 Sample Output

Standings Mode

{
    "team_name": "Colorado Avalanche",
    "team_abbrev": "COL",
    "conference": "Western",
    "division": "Central",
    "games_played": 66,
    "wins": 44,
    "losses": 13,
    "ot_losses": 9,
    "points": 97,
    "goals_for": 249,
    "goals_against": 170,
    "goal_differential": 79,
    "league_rank": 1,
    "home_record": "24-5-3",
    "away_record": "20-8-6",
    "fetched_at": "2026-03-18T12:00:00"
}

Player Stats Mode

{
    "player_id": 8478402,
    "full_name": "Connor McDavid",
    "team_abbrev": "EDM",
    "position": "C",
    "sweater_number": 97,
    "games_played": 60,
    "goals": 37,
    "assists": 78,
    "points": 115,
    "plus_minus": 25,
    "career_games": 650,
    "career_goals": 350,
    "career_points": 980,
    "fetched_at": "2026-03-18T12:00:00"
}

🏒 Team Abbreviations

Team	Abbrev	Team	Abbrev
Anaheim Ducks	ANA	New Jersey Devils	NJD
Boston Bruins	BOS	New York Islanders	NYI
Buffalo Sabres	BUF	New York Rangers	NYR
Calgary Flames	CGY	Ottawa Senators	OTT
Carolina Hurricanes	CAR	Philadelphia Flyers	PHI
Chicago Blackhawks	CHI	Pittsburgh Penguins	PIT
Colorado Avalanche	COL	San Jose Sharks	SJS
Columbus Blue Jackets	CBJ	Seattle Kraken	SEA
Dallas Stars	DAL	St. Louis Blues	STL
Detroit Red Wings	DET	Tampa Bay Lightning	TBL
Edmonton Oilers	EDM	Toronto Maple Leafs	TOR
Florida Panthers	FLA	Utah Hockey Club	UTA
Los Angeles Kings	LAK	Vancouver Canucks	VAN
Minnesota Wild	MIN	Vegas Golden Knights	VGK
Montreal Canadiens	MTL	Washington Capitals	WSH
Nashville Predators	NSH	Winnipeg Jets	WPG

⚡ Finding Player IDs

Player IDs can be found in NHL.com player page URLs. For example:

• Connor McDavid: https://www.nhl.com/player/connor-mcdavid-8478402 → ID: 8478402
• Auston Matthews: https://www.nhl.com/player/auston-matthews-8479318 → ID: 8479318

📝 Notes

• No API key required — Uses the free NHL public API
• Rate limiting — Built-in retry logic with backoff for API rate limits
• Current season — Defaults to the current NHL season when no date/season is specified
• Data freshness — Standings and stats are updated in near real-time by the NHL
• All 32 teams — Supports all current NHL franchises