TheTVDB TV Show Database Scraper
Pricing
from $10.00 / 1,000 results
Go to Apify Store
TheTVDB TV Show Database Scraper
Scrape TV series data from TheTVDB. Get TVDB IDs, status, networks, genres, sub-genres, runtimes, production companies, seasons, and episodes with air dates.
Pricing
from $10.00 / 1,000 results
Rating
0.0
(0)
Developer
lulz bot
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
17 days ago
Last modified
Categories
Share
Scrape comprehensive TV series metadata from TheTVDB.com, the community-driven TV show database used by media centers like Plex, Kodi, and Emby.
Features
- Search by name — Find any TV series using TheTVDB's search
- Browse popular — Scrape trending/popular series when no query is provided
- Direct URLs — Supply specific TheTVDB series URLs to scrape
- Rich metadata — TVDB ID, status, network, genres, sub-genres, runtime, production companies, country, language, geographic location, time period, favorites count
- Episode data — Optionally include full season/episode listings with air dates, descriptions, and thumbnails
- Pay per result — Only charges for data actually returned
Input Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
searchQuery | string | "" | Search for series by name (e.g. "Breaking Bad") |
seriesUrls | array | [] | Direct TheTVDB URLs to scrape (overrides search) |
includeEpisodes | boolean | false | Include season/episode data for each series |
maxResults | integer | 10 | Maximum number of series to return (1-100) |
proxyConfiguration | object | — | Optional proxy settings |
Output Fields
Each result contains:
| Field | Type | Description |
|---|---|---|
tvdbId | number | TheTVDB series ID |
name | string | Series title |
status | string | Continuing, Ended, Upcoming, etc. |
firstAired | string | First air date |
recentAired | string | Most recent air date |
airsSchedule | string | Air day and time |
network | string/array | Broadcasting network(s) |
productionCompany | string/array | Production company/companies |
runtime | number | Average runtime in minutes |
genres | array | Genre list (Crime, Drama, etc.) |
subGenres | array | Sub-genres (Psychological Thriller, etc.) |
country | string | Original country |
language | string | Original language |
geographicLocation | array | Geographic settings |
timePeriod | array | Time period settings |
overview | string | English plot synopsis |
aliases | array | Alternative titles |
favorites | number | Number of users who favorited |
image | string | Poster image URL |
seasons | array | Season list with episode counts |
totalSeasons | number | Number of seasons |
episodes | array | Episode data (when includeEpisodes is true) |
totalEpisodes | number | Total episode count |
url | string | TheTVDB series page URL |
scrapedAt | string | ISO timestamp |
Example Usage
Search for a series
{"searchQuery": "Breaking Bad","maxResults": 3}
Scrape specific series with episodes
{"seriesUrls": ["https://thetvdb.com/series/breaking-bad","https://thetvdb.com/series/better-call-saul"],"includeEpisodes": true}
Browse popular series
{"maxResults": 20}
Use Cases
- Media center databases — Keep Plex/Kodi/Emby metadata in sync
- TV analytics — Track show status, networks, and popularity
- Content research — Analyze genres, runtimes, and air schedules
- Watchlist apps — Build TV tracking and recommendation tools
- Data journalism — Research TV industry trends and patterns
Notes
- TheTVDB is the primary metadata source for many media applications
- Series detail pages are fully server-rendered (no JavaScript required)
- Episode scraping increases runtime proportionally to series size
- Rate-limited to avoid overloading the server