TheTVDB TV Show Database Scraper avatar

TheTVDB TV Show Database Scraper

Pricing

from $10.00 / 1,000 results

Go to Apify Store
TheTVDB TV Show Database Scraper

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

lulz bot

Maintained by Community

Actor 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

ParameterTypeDefaultDescription
searchQuerystring""Search for series by name (e.g. "Breaking Bad")
seriesUrlsarray[]Direct TheTVDB URLs to scrape (overrides search)
includeEpisodesbooleanfalseInclude season/episode data for each series
maxResultsinteger10Maximum number of series to return (1-100)
proxyConfigurationobjectOptional proxy settings

Output Fields

Each result contains:

FieldTypeDescription
tvdbIdnumberTheTVDB series ID
namestringSeries title
statusstringContinuing, Ended, Upcoming, etc.
firstAiredstringFirst air date
recentAiredstringMost recent air date
airsSchedulestringAir day and time
networkstring/arrayBroadcasting network(s)
productionCompanystring/arrayProduction company/companies
runtimenumberAverage runtime in minutes
genresarrayGenre list (Crime, Drama, etc.)
subGenresarraySub-genres (Psychological Thriller, etc.)
countrystringOriginal country
languagestringOriginal language
geographicLocationarrayGeographic settings
timePeriodarrayTime period settings
overviewstringEnglish plot synopsis
aliasesarrayAlternative titles
favoritesnumberNumber of users who favorited
imagestringPoster image URL
seasonsarraySeason list with episode counts
totalSeasonsnumberNumber of seasons
episodesarrayEpisode data (when includeEpisodes is true)
totalEpisodesnumberTotal episode count
urlstringTheTVDB series page URL
scrapedAtstringISO 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
}
{
"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