TVMaze

Overview

TVMaze’s public API is the best free source of TV-show data: shows, episodes, seasons, cast, images, schedules, and embedded web/episode info — keyless and regularly updated. A favorite for TV-tracking apps, episode calendars, and “what’s on tonight” widgets.

Quick Start

Search shows (verified live — Breaking Bad):

curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad"

With embedded episodes & cast:

curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad&embed=episodes"
curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad&embed=cast"

Show lookup by TVmaze ID:

curl "https://api.tvmaze.com/shows/169"

Episode list:

curl "https://api.tvmaze.com/shows/169/episodes"

Today’s schedule (US):

curl "https://api.tvmaze.com/schedule?country=US"

Authentication

None — keyless.

Rate Limits & Notes

• Free, no documented hard limit — but the docs ask for no more than 20 requests per 10 seconds and a reasonable User-Agent.
• embed=episodes|cast|seasons enriches a single response (fewer round-trips).
• Show/episode IDs are stable; episodes have airdates and season numbers for calendar apps.
• schedule supports country, date, and web filters.

FAQ

Is TVMaze free? Yes — free and keyless (be polite: ~20 req/10s).

Can I get episodes and cast in one call? Yes — embed=episodes,cast returns them embedded.

How do I find a show by name? /singlesearch/shows?q=NAME returns the best match.