Pricing

Rating

Developer

Actor stats

Categories

Share

👁 ParseForge Banner

🎬 TVMaze TV Shows Scraper

🚀 Search TV shows or browse the entire TVMaze catalog of 80,000+ titles.

🕒 Last updated: 2026-05-06 · 📊 35 fields per record · 80,000+ TV shows · poster, cast, episodes, IMDB/TheTVDB IDs, network, schedule, ratings

The TVMaze TV Shows Scraper searches TV-show metadata or browses the full TVMaze catalog of 80,000+ titles. Output includes name, poster, type, language, genres, status, runtime, network, country, premiere and end dates, IMDB/TheTVDB IDs, summary, and rating. Optional embeds add full episode lists, cast, and alternate-region titles.

Beyond search and browse, the Actor includes a Schedule mode that returns every episode airing on a given day in a given country, and a Streaming Schedule mode for web-only releases. Four modes in one Actor cover discovery, deep cataloging, and real-time TV scheduling.

📋 What the TVMaze TV Shows Scraper does

Five filtering workflows in a single run:

• 🔍 Search by name. Find shows by title (capped at 10 results per query).
• 📚 Browse mode. Paginate the entire 80,000+ TVMaze catalog.
• 📅 Schedule mode. Every episode airing on a date in a country.
• 🌐 Web schedule. Streaming-only releases per date.
• 🎭 Optional embeds. Episodes, cast, and AKAs per show.

💡 Why it matters: clean, server-side filtering removes the parser-and-pagination work from your team and keeps your dataset fresh on every run.

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

⚙️ Input

Example: search Breaking Bad with cast.

{
"maxItems":5,
"mode":"search",
"query":"breaking bad",
"includeCast":true
}

Example: browse 1,000 shows from page 0.

{
"maxItems":1000,
"mode":"browse",
"browseStartPage":0
}

📊 Output

Each record contains 35 fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

📦 Sample records

✨ Why choose this Actor

📈 How it compares to alternatives

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the TVMaze TV Shows Scraper page on the Apify Store.
3. 🎯 Set input. Pick your filters and maxItems.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

💼 Business use cases

🔌 Automating TVMaze TV Shows Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Hourly, daily, or weekly refreshes keep downstream databases in sync automatically.

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (search, browse, schedule, webSchedule). The Actor queries TVMaze and emits one record per show, optionally embedding episodes/cast/AKAs.

🔍 Why does search cap at 10 results?

TVMaze's search endpoint limits any single query to ~10 results. For more, use browse mode (250 shows per page, paginated).

📊 How many fields per record?

Up to 35 base fields, plus optional embeds for episodes, cast, and alternate titles.

📅 What does schedule mode return?

Every episode airing on the given date in the given country, with the parent show metadata for each.

🌐 Does it include international shows?

Yes. TVMaze covers shows from 100+ countries, with original-language titles and AKA entries.

🔁 Can I schedule recurring runs?

Yes. Use Apify Schedules to track new shows, refresh ratings, or build daily EPGs.

⚖️ Is this data public?

Yes. TVMaze publishes its API under a permissive license. Only public catalog data is collected.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs. A paid plan unlocks higher item counts and scheduling.

🆘 What if a run fails?

Apify retries transient errors. Partial datasets are preserved.

🎭 Does it return cast photos?

Yes when includeCast is true. Cast records include personImage URLs.

🔌 Integrate with any app

TVMaze TV Shows Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes.

🔗 Recommended Actors

• 🎙️ iTunes Podcast Search - Apple Podcasts catalog (5M+ shows)
• 🎌 AniList Anime/Manga - Anime, manga, light novels
• 🎨 Openverse Media - 800M+ openly licensed images and audio
• 📰 Hacker News Search - Every HN story since 2007
• 🌐 Wikidata Entity Search - 100M+ open knowledge-graph entities

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TVMaze or any television network or production company. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.