Pricing
Pay per event
Next-Episode.net TV Release Calendar Scraper
Scrape upcoming and recent TV episode air dates from next-episode.net. The weekly schedule covers 100+ shows with season/episode codes, networks, and premiere/finale status. Ideal for EPG builders, content-alert apps, and streaming teams timing campaigns to premieres.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
a month ago
Last modified
Categories
Share
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:
- 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. - 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.
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_titlewill always benullin 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.
