NFL Schedule Scraper

Scrapes every game from the official NFL schedule at nfl.com. Returns preseason, regular season, and postseason games with kickoff times, venues, broadcast networks, and primetime flags — all from the canonical source.

---

NFL Schedule Scraper Features

• Scrapes preseason, regular season, and postseason games for any season year
• Returns home and away teams with full names and three-letter abbreviations
• Captures kickoff time in both local date and UTC ISO 8601 format
• Identifies the primary broadcast network (CBS, FOX, NBC, ESPN, NFL Network)
• Flags primetime games: Sunday Night Football (SNF), Monday Night Football (MNF), Thursday Night Football (TNF)
• Marks international games (London, Munich, Brazil series)
• Includes game status (SCHEDULED, IN_PROGRESS, FINAL) and venue information
• Supports all season types with a single input parameter

---

Who Uses NFL Schedule Data?

• Fantasy sports developers — sync weekly game schedules, bye weeks, and kickoff times for draft apps and lineup tools
• Sports betting platforms — pull primetime matchups, venue data, and broadcast networks to power odds display
• Media companies — automate weekly schedule content, highlight TNF/MNF/SNF games for programming guides
• Data analysts — build historical season datasets for performance modeling across venues and networks
• App developers — display current-week NFL schedules without parsing the official site manually

---

How NFL Schedule Scraper Works

1. Provide a season year (e.g. 2026) and optionally a season type (PRE, REG, POST)
2. The scraper enumerates all week URLs for the selected season type
3. Each page's embedded React Query JSON is parsed — no JavaScript execution required
4. Games are extracted and returned with all schedule fields

---

Input

{
  "season": 2026,
  "seasonType": "REG",
  "maxItems": 0
}

Parameter	Type	Default	Description
season	integer	(required)	NFL season year (e.g. 2026)
seasonType	string	REG	PRE, REG, POST, or blank for all three
maxItems	integer	0	Maximum records to return. 0 = unlimited

---

Output

Each record represents one NFL game.

Field	Type	Description
season	integer	Season year (e.g. 2026)
week	integer	Week number within the season type
game_id	string	NFL game UUID
kickoff_local	string	Kickoff date in YYYY-MM-DD format (local)
kickoff_utc	string	Kickoff datetime in UTC (ISO 8601)
home_team	string	Home team full name
home_team_abbrev	string	Home team abbreviation (e.g. SEA)
away_team	string	Away team full name
away_team_abbrev	string	Away team abbreviation (e.g. NE)
home_score	integer	Home team final score (null if not yet played)
away_score	integer	Away team final score (null if not yet played)
venue	string	Stadium/venue name
venue_city	string	City where the game is played
broadcast_network	string	Primary broadcast TV network
status	string	Game status (SCHEDULED, IN_PROGRESS, FINAL)
is_thursday_night	boolean	Thursday Night Football game
is_monday_night	boolean	Monday Night Football game
is_sunday_night	boolean	Sunday Night Football game
is_international	boolean	Game played outside the United States
source	string	Source URL of the schedule page

---

Sample Output

{
  "season": 2026,
  "week": 1,
  "game_id": "a8fb0d78-4feb-11f1-abca-2c54536568a9",
  "kickoff_local": "2026-09-10",
  "kickoff_utc": "2026-09-10T00:20:00Z",
  "home_team": "Seattle Seahawks",
  "home_team_abbrev": "SEA",
  "away_team": "New England Patriots",
  "away_team_abbrev": "NE",
  "home_score": null,
  "away_score": null,
  "venue": "Lumen Field",
  "venue_city": "Seattle",
  "broadcast_network": "NBC",
  "status": "SCHEDULED",
  "is_thursday_night": false,
  "is_monday_night": false,
  "is_sunday_night": true,
  "is_international": false,
  "source": "https://www.nfl.com/schedules/2026/REG1/"
}

---

Coverage & Season Structure

The NFL 2026 season includes:

• Preseason: Hall of Fame game (week 0) + 4 exhibition weeks (Aug 7 – Aug 28)
• Regular season: 18 weeks, 272 games (Sept 10 – Jan 3)
• Postseason: Wild Card, Divisional, Conference, Pro Bowl, Super Bowl (Jan 2027)

Weeks that haven't been scheduled yet return zero records rather than erroring.

---

Technical Notes

Data is extracted from the NFL's Next.js server-rendered page. Game records are embedded in the HTML's React hydration payload — fully available without JavaScript execution, making Cheerio sufficient. No browser required, no proxies required.

---

Need help or want a feature?

Contact us at actor-support@orbtop.com or open a GitHub issue.