TVMaze TV Shows Intelligence

Extract comprehensive TV show data from TVMaze - episodes, cast, schedules, ratings and more

What you get

• Clean, validated JSON ready for your pipeline
• Pre-built dataset Overview in the Apify Console for instant inspection
• Reliable & maintained — patched whenever the source changes

Why this actor (vs. alternatives)

	Build your own	Generic scraper	This actor
Maintenance	You patch every change	Often broken	Patched continuously
Structured output	Manual parsing	Inconsistent	Validated schema
Setup time	Days	Hours	Minutes
Pay only for results	N/A	Varies	Yes (pay-per-use)

Input

Field	Type	Description
mode (required)	string	How to search for TV shows Options: search, show_details, schedule, streaming, people
query	string	Search query for shows or people
showId	integer	TVMaze show ID for getting detailed information
country	string	Country code for schedule (e.g., US, GB, CA)
date	string	Date for schedule in YYYY-MM-DD format (defaults to today)
includeEpisodes	boolean	Include episode list when getting show details
includeCast	boolean	Include cast list when getting show details
maxResults	integer	Maximum number of results to return

Example Input

{
  "mode": "search",
  "country": "US",
  "includeEpisodes": false,
  "includeCast": false,
  "maxResults": 100
}

Use cases

• Content / catalog apps — populate listings with rich metadata
• AI assistants — ground LLM responses in real reference data
• Education platforms — teach with structured real-world data
• Research — analyze trends across the dataset
• Recommendation engines — power suggestions with metadata

Pricing

Pay-Per-Event:

• $0.001 per result
• $0.00005 actor-start fee

Example runs

Use case	Results	Cost
Quick scan	100	$0.10
Standard run	500	$0.50
Bulk dataset	2,000	$2.00

FAQ

Q: How fresh is the data?
A: Real-time — every run fetches live from the source.

Q: Do I pay for failed or empty runs?
A: You pay per result returned, plus a tiny actor-start fee.

Q: Can I schedule recurring runs?
A: Yes — use the Apify Console scheduler for daily/weekly automation.

Q: Can I export the data?
A: Yes — JSON, CSV, Excel, and API access are all supported by Apify.

Related actors

• book-intelligence — 20M+ books
• openlibrary-book-intelligence — Open Library books
• recipe-intelligence — recipe database
• cocktail-intelligence — cocktail recipes

Legal & compliance

This actor retrieves publicly accessible data only. You are responsible for respecting the source's Terms of Service, honoring robots.txt, and complying with GDPR / applicable regulations for any personal data.

Support & feature requests

Open an issue on the Actor page or contact via Apify Console messaging. Custom features welcome.