Next-Episode.net TV Release Calendar Scraper

Scrape upcoming and recently aired TV episode air dates from next-episode.net. Each run produces one structured record per episode, covering 100+ shows with season/episode codes, networks, air times, and premiere/finale status flags.

What it does

The actor crawls next-episode.net's public weekly schedule pages and enriches each episode entry with show-level metadata from the individual show pages:

1. Schedule pages — fetches /schedule/?week=0 (current week) and optionally future weeks. Each page lists every episode airing that week with its date, time slot, network, and episode code.
2. Show detail pages — for each unique show found on the schedule, fetches the show's page to extract the country of broadcast, show status (returning/cancelled/ended), and next/previous episode summaries.

Output is one flat record per episode.

Input

Field	Type	Default	Description
maxItems	integer	10	Maximum number of episode records to return. Leave blank for all.
weeksAhead	integer	0	Number of future weeks to include. 0 = current week only, 1 = adds next week, up to 8.

Tip: A single week typically contains 80–150 episodes across 50–120 shows. Keep weeksAhead at 0–1 for focused runs, or increase it to build a multi-week release calendar.

Output

Each record represents one episode airing on the schedule.

{
  "show_name": "Andor",
  "show_slug": "andor",
  "season_number": 2,
  "episode_number": 6,
  "episode_code": "S02E06",
  "episode_title": null,
  "air_date": "2025-05-27",
  "air_time": "12:00 AM",
  "network": "Disney+",
  "country": "US",
  "is_series_premiere": false,
  "is_series_finale": false,
  "status": "upcoming",
  "next_episode_summary": "Episode 7 airs June 3",
  "previous_episode": "S02E05: Harvest (Wed May 21, 2025)"
}

Field reference

Field	Description
show_name	Full display name of the show
show_slug	URL slug used on next-episode.net (e.g. breaking-bad)
season_number	Season number (integer, or null if not parsed)
episode_number	Episode number within the season (integer, or null if not parsed)
episode_code	Formatted episode code (e.g. S02E05), derived from the schedule's 2x05 notation
episode_title	Episode title — currently null (not exposed on schedule pages)
air_date	Air date in YYYY-MM-DD format
air_time	Scheduled air time as listed on the schedule (e.g. 9:00 PM)
network	Network or streaming platform (e.g. Prime Video, AMC, Netflix)
country	Two or three-letter country code of the broadcast market (e.g. US, UK)
is_series_premiere	true if this is S01E01 of the series
is_series_finale	true if the show is cancelled/ended and this episode has season/episode data
status	upcoming or aired based on the episode's air date relative to today
next_episode_summary	Next episode block text from the show page, or null
previous_episode	Formatted string with previous episode info, e.g. S01E05: Name (date)

Use cases

• EPG / release calendar apps — build a weekly or multi-week episode grid keyed by air date and time slot
• Content alert bots — trigger notifications when a favourite show's new episode appears on the schedule
• Streaming analytics — track which platforms are airing new content each week and spot premiere/finale patterns
• Watchlist automation — detect series premieres (is_series_premiere: true) to automatically add new shows to a tracker

Notes

• next-episode.net updates its schedule continuously. Re-run the actor weekly (or more frequently) to stay current.
• Episode titles are not shown on the public schedule pages; episode_title will always be null in the current version.
• The schedule is US-centric but includes international streaming releases (Netflix, Apple TV+, Disney+, etc.).
• Air times reflect the timezone shown on next-episode.net, which is typically the originating network's local time.