TV Shows Scraper — Episodes & Cast (TVMaze)

Get complete TV show data — metadata, full episode lists and cast — from the free TVMaze API in one call. Search by name or look up by id/URL, and get genres, network, rating, IMDb id, every episode and the full cast. No key, no proxies.

Perfect for media / streaming apps, episode guides, recommendation tools and TV datasets.

What you get

Per show:

• Identity — id, name, type, language, url, officialSite, image
• Classification — genres, status (Running/Ended), runtime, premiered, ended
• Ratings & network — rating (average), network, country
• Cross-IDs — imdb, thetvdb
• Summary — plain-text (HTML stripped)
• Optional episodes (when includeEpisodes on) — name, season, number, airdate, runtime, rating, summary, url
• Optional cast (when includeCast on) — person + character pairs

Input

Field	Type	Default	Description
searchTerms	array	—	Show names to search, e.g. breaking bad
shows	array	—	TVMaze show ids or URLs, e.g. 169
includeEpisodes	boolean	false	Also fetch the full episode list per show
includeCast	boolean	false	Also fetch the cast per show
maxResultsPerSearch	integer	10	Shows returned per search term

Provide at least one of searchTerms or shows.

Example input

{
  "searchTerms": ["breaking bad"],
  "shows": ["https://www.tvmaze.com/shows/169/breaking-bad"],
  "includeEpisodes": true,
  "includeCast": true
}

Output (one show)

Fields below are the real normalizer output:

{
  "id": 169,
  "name": "Breaking Bad",
  "type": "Scripted",
  "language": "English",
  "genres": ["Drama", "Crime", "Thriller"],
  "status": "Ended",
  "runtime": 60,
  "premiered": "2008-01-20",
  "ended": "2013-09-29",
  "rating": 9.2,
  "network": "AMC",
  "country": "United States",
  "officialSite": "http://www.amc.com/shows/breaking-bad",
  "imdb": "tt0903747",
  "thetvdb": 81189,
  "image": "https://static.tvmaze.com/uploads/images/original_untouched/0/2400.jpg",
  "summary": "Breaking Bad follows Walter White, a chemistry teacher...",
  "url": "https://www.tvmaze.com/shows/169/breaking-bad",
  "episodes": [
    { "name": "Pilot", "season": 1, "number": 1, "airdate": "2008-01-20", "runtime": 60, "rating": 8.2, "summary": "...", "url": "https://www.tvmaze.com/episodes/1/breaking-bad-1x01-pilot" }
  ],
  "cast": [{ "person": "Bryan Cranston", "character": "Walter White" }]
}

episodes and cast appear only when their options are enabled.

Why this actor

• Everything in one call — show + episodes + cast, no per-episode follow-ups.
• Keyless & clean — the free public TVMaze API, no anti-bot; HTML summaries stripped to plain text.
• Cross-IDs included — IMDb and TheTVDB ids for easy joining.

Pricing

Pay per result — $2.00 per 1,000 results (one result = one show). No subscription or platform fees.

Related actors

• TMDB Scraper — movies, TV and people with deep detail (BYO key).
• JustWatch Scraper — where to stream / rent / buy any title, per country.

Notes & limits

• Search is name-based and broad; pass exact ids/URLs in shows for precise lookups.
• Independent tool built on the free public TVMaze API; not affiliated with or endorsed by TVMaze. You are responsible for compliant use of the output.