OrbTop

NFL Schedule Scraper

SPORTS

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.