OrbTop

Next-Episode.net TV Release Calendar Scraper

NEWSFOR CREATORS
Try on Apify

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.
Try on Apify