TVMaze TV Shows Scraper

📺 TVMaze TV Shows Scraper

Search and extract TV show metadata from the TVMaze API — episode guides, cast info, ratings, and daily TV schedules.

Free, no API key required.

🔥 Features

• Search: Find TV shows by name
• Show Details: Full metadata including rating, network, schedule, images
• Episodes: Complete episode lists with air dates and summaries
• Cast: Actor/character information
• Schedule: Daily TV schedule by country
• People Search: Find actors by name

📋 Input Parameters

Parameter	Type	Description
Mode	Select	Search Shows / Show Details / Daily Schedule / Episodes / People
Search Query	Text	Show or person name to search
Show ID	Number	TVMaze show ID for details mode
Include Episodes	Boolean	Include full episode list
Include Cast	Boolean	Include cast members
Schedule Country	Text	Country code (US, GB, AU, etc.)
Schedule Date	Text	Date for schedule (YYYY-MM-DD)
Max Results	Number	Maximum items to return

📊 Output Examples

Show Output

{
  "source": "show",
  "id": 169,
  "name": "Breaking Bad",
  "type": "Scripted",
  "language": "English",
  "genres": ["Drama", "Crime", "Thriller"],
  "status": "Ended",
  "premiered": "2008-01-20",
  "ended": "2013-09-29",
  "rating": 9.2,
  "network_name": "AMC",
  "network_country": "US",
  "image_medium": "https://static.tvmaze.com/...",
  "fetched_at": "2026-03-28T12:30:00Z"
}

Episode Output

{
  "source": "episode",
  "id": 4283,
  "name": "Pilot",
  "season": 1,
  "number": 1,
  "airdate": "2008-01-20",
  "airtime": "22:00",
  "runtime": 58,
  "rating": 8.5,
  "show_name": "Breaking Bad",
  "fetched_at": "2026-03-28T12:30:00Z"
}

Cast Output

{
  "source": "cast",
  "person_id": 20831,
  "person_name": "Bryan Cranston",
  "character_name": "Walter White",
  "show_name": "Breaking Bad",
  "fetched_at": "2026-03-28T12:30:00Z"
}

💡 Use Cases

• Content Discovery: Find shows matching specific criteria
• Media Analytics: Track ratings, episode counts, and status
• Entertainment Apps: Build show trackers and recommendation systems
• Cast Research: Explore actor filmographies

📊 Data Source

TVMaze API — tvmaze.com

• Coverage: 80,000+ TV shows
• Updates: Real-time schedule data
• Rate limit: 20 requests/second

🔗 Related Actors

• Hacker News Scraper — Tech news
• Bing News Scraper — General news

⚙️ Maintenance

This Actor is actively maintained. For issues or feature requests, please contact the developer.