TVmaze Scraper
Pricing
from $2.99 / 1,000 results
TVmaze Scraper is a Python tool designed to extract TV show metadata, episode guides, cast details, air dates, and schedules from TVmaze. It exports structured television data into clean CSV or JSON formats for entertainment analytics and media tracking.
What to collect: show search, one show, all episodes, people, a country or web schedule, recently updated shows, or the show index.
Show titles for search mode, or person names for people mode. One query per line.
Use TVmaze singlesearch and keep one show per query. A miss is saved as a NOT_FOUND row.
TVmaze show ids (169), show URLs, IMDb ids (tt0903747 or imdb:tt0903747), or TheTVDB ids (tvdb:81189). Used by shows and episodes modes.
[ "169", "tt0903747", "tvdb:81189"]In shows mode, load episodes with the show. Turn off to skip that request.
Ask for specials=1 on the episodes endpoint. This replaces the episodes embed so specials are included.
In shows mode, embed the cast on the show request.
In shows mode, load crew as an extra request.
In shows mode, load seasons as an extra request.
In shows mode, load alternate titles (akas) as an extra request.
In shows mode, write each episode as its own dataset row instead of nesting them on the show.
ISO 3166-1 alpha-2 country codes for schedule mode, one per line. Empty uses US.
[ "US", "GB"]Dates for the country schedule and the web schedule. Empty means today (UTC).
[ "2026-10-12"]Also call the web schedule for each date. The show sits under the embedded show object.
How far back the updates feed should look: the last day, week, or month.
After the updates feed, load each show and save a show row as well as the update row.
First page of the show index. Page 0 is the start. The run stops at the first 404.
Stop after this many dataset rows, including error rows. Free cap 20,000. Nested episode lists are also capped.
Ceiling for TVmaze calls in any 10 second window. TVmaze allows at least 20 calls per 10 seconds per IP. Default is 18.
Stop the run after this many seconds and keep rows already saved.
How long to wait for one TVmaze response before treating it as a failed request.