TVMaze Scraper

Search TV shows and people, or list a show's episodes, using the free TVMaze API. No API key, no login. You get clean, flat rows — HTML summary fields are already converted to plain text.

Modes

Mode	Needs	Returns
shows	query (show name)	Matching TV shows
people	query (person name)	Matching actors / crew
episodes	showId (integer)	Every episode of that show

Find a showId by running shows mode first — each show row includes its id.

Output

One dataset row per result, flagged ok: true.

Shows (mode: "shows"): id, name, type, language, genres (array), status, runtime, premiered, ended, rating (average, 0–10 or null), network (network or web-channel name), country (name), imdb (IMDb id), officialSite, summary (plain text), image (URL), url (TVMaze page).

People (mode: "people"): id, name, country (name), birthday, gender, image (URL), url.

Episodes (mode: "episodes"): showId, episodeId, name, season, number, airdate, runtime, rating, summary (plain text), url.

Fields that can be null

TVMaze omits fields it doesn't have, so any field above can be null — e.g. rating when a show/episode has no votes, ended for a running show, network/country for web-only shows, imdb when no external id is mapped, birthday/gender for some people, or image when no artwork exists.

Pricing

$2.00 per 1,000 rows ($0.002 each), with no run-start fee. Flat rate — no volume tiers, no plan gates — and you are charged only for rows actually returned.

Pay-per-result: you are charged once per genuine result row (ok: true). You are never charged for:

• invalid input (a single ok: false row with errorCode: "BAD_INPUT"),
• no matching results (NO_RESULTS),
• an unknown showId (NOT_FOUND),
• network / rate-limit / server errors (NETWORK / RATE_LIMITED / SERVER_ERROR).

Results are deduplicated by id before charging.

Proxy

The TVMaze API is a public, no-auth JSON API with no anti-bot, so no proxy is required and the default runs without one (saving proxy credits). Only enable Apify Proxy if you hit IP rate limits at very high volume.

Examples

Search shows:

{ "mode": "shows", "query": "breaking bad", "maxItems": 10 }

List a show's episodes:

{ "mode": "episodes", "showId": 169 }

Search people:

{ "mode": "people", "query": "bryan cranston", "maxItems": 5 }

Notes

TVMaze search returns the best matches ranked by relevance (their score). Episode lists are returned in full for the show; use maxItems to cap how many rows you keep. Data is courtesy of TVMaze.com under their licensing terms.