TV Shows Scraper (TVMaze)

hipersoft/tvmaze-scraper

Search TV shows and scrape full data from TVMaze: name, genres, network, status, premiere/end dates, rating, IMDb id, summary — plus every episode (season, number, airdate, rating) and full cast. Fast clean HTTP, no setup.

Run this scraper →See the API call

Total users

Monthly users

Total runs

116

Per item scraped

$0.001

Last rebuilt

Oct 28, 2026

Overview

Search TV shows and pull clean, structured JSON from TVMaze: name, genres, network, status, premiere and end dates, rating, IMDb ID, summary — and optionally every episode and the full cast. It runs over the free public TVMaze API, so it's fast and needs no account and no API key. Ideal for building TV databases, powering guides and apps, or running media research.

TV Shows Scraper (TVMaze) input — searches, showIds and include toggles in the Apify Console

Features

📺 Full show data — genres, network, status, premiered/ended, rating, runtime, imdbId and cleaned summary.
🎬 Episode guide — enable includeEpisodes for every episode's season, number, airdate, runtime and rating.
🎭 Cast lists — enable includeCast to get actor and character pairs with country, birthday and photo.
🆔 Target by ID — pass exact TVMaze showIds alongside or instead of keyword searches.
🔗 External IDs — show records include imdbId and tvdbId for easy cross-referencing.
🎚️ Volume control — maxShowsPerSearch (1–50) caps matches kept per search term.
🧱 Flat, normalized JSON — typed show, episode and cast records with consistent fields.

What you get

TV Shows Scraper (TVMaze) output example — show, episode and cast rows as structured JSON

One flat JSON record per item. Example show:

{
  "type": "show",
  "id": 169,
  "name": "Breaking Bad",
  "showType": "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",
  "scheduleDays": ["Sunday"],
  "scheduleTime": "22:00",
  "officialSite": "http://www.amc.com/shows/breaking-bad",
  "imdbId": "tt0903747",
  "tvdbId": 81189,
  "image": "https://static.tvmaze.com/uploads/images/original_untouched/0/2400.jpg",
  "summary": "A high school chemistry teacher turned methamphetamine producer.",
  "url": "https://www.tvmaze.com/shows/169/breaking-bad"
}

Output schema

Field	Type	Description
`type`	string	Record type — `show`, `episode` or `cast`.
`id`	integer	TVMaze numeric ID for the show.
`name`	string	Show title.
`showType`	string	Format of the show, e.g. `Scripted`.
`language`	string	Primary language the show is produced in.
`genres`	array	List of genre labels for the show.
`status`	string	Airing status, e.g. `Running` or `Ended`.
`runtime`	integer	Typical episode length in minutes.
`premiered`	string	First air date (`YYYY-MM-DD`).
`ended`	string	Last air date, or empty if still running.
`rating`	number	Average viewer rating out of 10.
`network`	string	Name of the broadcasting network.
`country`	string	Country the network is based in.
`scheduleDays`	array	Days of the week the show airs.
`scheduleTime`	string	Local air time (`HH:MM`).
`officialSite`	string (URL)	Link to the show's official website.
`imdbId`	string	IMDb identifier for cross-referencing.
`tvdbId`	integer	TheTVDB numeric identifier.
`image`	string (URL)	Link to the show's poster image.
`summary`	string	Plain-text synopsis of the show.
`url`	string (URL)	TVMaze page URL for the show.

Input

{
  "searches": ["breaking bad", "the office"],
  "showIds": [],
  "includeEpisodes": true,
  "includeCast": true,
  "maxShowsPerSearch": 10
}

Field	Description
`searches`	TV show titles or keywords, one per line.
`showIds`	Specific TVMaze show IDs (optional).
`includeEpisodes`	Also fetch every episode of each show.
`includeCast`	Also fetch each show's cast (actor and character).
`maxShowsPerSearch`	How many matches to keep per search term (1–50).

Use cases

Build a TV database with genres, networks, ratings and IMDb IDs.
Generate a full episode guide (seasons, airdates, ratings) for any show.
Map cast and character relationships across shows.
Cross-reference titles to IMDb/TheTVDB via imdbId and tvdbId.

Pricing

Pay-per-event: you're billed a small amount per run and per item scraped — you only pay for what you get. See the Pricing tab for current rates.

FAQ

Do I need an account or API key? No. The Actor runs over the free public TVMaze API, so there's no account and no API key to set up.

How many shows can I get per run? Set maxShowsPerSearch (1–50) to cap matches kept per search term. Pass multiple titles in searches, or target exact showIds, to scale a single run.

Can I download episodes or video? No. This Actor returns public metadata only — show, episode and cast details. It does not download any video content.

What's the output format? Flat, normalized JSON with typed show, episode and cast records and consistent fields. Export as JSON, CSV or Excel.

Can I get episodes and cast, not just show details? Yes. Enable includeEpisodes for every episode's season, number, airdate, runtime and rating, and includeCast for actor and character pairs with photos.

Can I connect this to other apps and services? The TV Shows Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. It works with Make, Zapier, Slack, Airbyte, GitHub, Google Drive and many more, plus the Apify API, JavaScript/Python clients and MCP. Or use webhooks to trigger an action whenever a run finishes.

Building a media or entertainment dataset? Pair this with our other entertainment scrapers:

YouTube Scraper — video metadata, transcripts, comments and channel profiles.
Steam Games Scraper — game prices, genres, platforms and Metacritic scores.
Apple Podcasts Scraper — podcast shows and episodes with RSS feeds and artwork.
Spotify Scraper — tracks, artists, albums and playlists with no login or API key.

Notes

This Actor uses the public TVMaze API and returns public metadata only — no video content. Not affiliated with, endorsed by, or connected to TVMaze; all trademarks belong to their respective owners.

Input

Field	Type	Description
`searches` Show searches	array	TV show titles or keywords (e.g. "breaking bad", "the office"), one per line.
`showIds` Show IDs (optional)	array	Specific TVMaze show IDs (e.g. 169). One per line.
`includeEpisodes` Include episodes	boolean	Also fetch every episode of each show (season, number, airdate, rating, summary). Default: `false`
`includeCast` Include cast	boolean	Also fetch each show's cast (actor and character). Default: `false`
`maxShowsPerSearch` Max shows per search	integer	How many matches to keep per search term. Default: `10`
`proxyConfiguration` Proxy (optional)	object	Optional. The TVMaze API works without a proxy. Default: `{"useApifyProxy": false}`

API

curl -X POST "https://api.apify.com/v2/acts/hipersoft~tvmaze-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "searches": [
    "breaking bad"
  ],
  "showIds": []
}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/tvmaze-scraper").call(run_input={
    "searches": [
        "breaking bad"
    ],
    "showIds": []
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/tvmaze-scraper').call({
  "searches": [
    "breaking bad"
  ],
  "showIds": []
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

Event	Price	Paid plans from
Item scraped One show, episode or cast member with full metadata	$0.001	$0.0005
API request One TVMaze API request (a search, episodes list or cast list)	$0.001	$0.001

You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.

Related scrapers

Bulk Image Downloader

Download thousands of images from a list of URLs and store each in the key-value store with a public link. Returns content type, size, dimensions and SHA-256 per image. Bulk-ready. Great for datasets, backups and media pipelines.

8,102 runs · 103 users · $0.056 / url processed

Text to Speech

Convert any text to natural-sounding speech as an MP3 download. 300+ premium neural voices across 70+ languages, adjustable rate, pitch and volume. Great for voiceovers, videos, accessibility and audio content. No setup.

278 runs · 22 users · $0.01 / audio generated

Google Maps Email Extractor

Search Google Maps for businesses, then crawl each business website to extract emails, social profiles and extra phone numbers. Turns any Maps search into a ready lead list. No setup.

159 runs · 8 users · $0.006 / business lead scraped

Website Screenshot

Capture full-page or viewport screenshots of any URL as PNG or JPEG, at any device size. For monitoring, previews, thumbnails and automation workflows.

156 runs · 3 users · $0.004 / screenshot captured

Bulk URL Status Checker

Check thousands of URLs over plain HTTP: status codes, broken links (404/410/5xx), full redirect chains, response time, content type, page title and SSL certificate expiry.

154 runs · 13 users · $0.002 / url checked

Google Search Scraper

Scrape Google Search results (organic listings) for any query: title, URL, displayed URL, snippet and position. Multi-query, per-country/language, pagination. Uses Google SERP proxy — reliable, no captcha, no setup.

121 runs · 8 users · $0.001 / result scraped

Need a source that isn't here?

Send the site and the fields. We build it and you get it first.

Request a build