TVMaze
TV Show Data.
About TVMaze
TVmaze provides a free REST API for TV show data, returning JSON responses that conform to HATEOAS and HAL principles. The API's root URL is https://api.tvmaze.com and includes endpoints for searching shows and people, retrieving schedules by country or web/streaming channel, and looking up detailed show information including episodes, seasons, cast, crew, and images. Shows can also be looked up using thetvdb or IMDB IDs, with results redirecting to the corresponding TVmaze show page.
The API supports fuzzy search for shows and people, with both a multi-result search endpoint and a singlesearch endpoint that returns exactly one match. Schedule endpoints cover country-specific broadcast schedules, web/streaming schedules distinguishing local and global channels, and a full schedule of all future episodes across all countries, which is cached for 24 hours due to its size. Endpoints for episode-level detail include lookup by season and episode number, by air date, and access to guest cast and crew.
The service is intended for developers building websites or apps that need to display TV information, such as show details, schedules, or cast data. In addition to the free public API, a separate user-level API is available for Premium members, with its own documentation. The API supports embedding related information (such as episodes or cast) directly into responses to reduce the number of requests needed.
Key features
- Search shows by name with fuzzy matching
- Look up shows by TheTVDB or IMDB ID
- Retrieve full episode lists, season/episode data, and alternate orderings
- Get daily TV schedules by country or web/streaming channel
- Search and retrieve people (cast/crew) information
- Free REST API returning JSON, conforming to HATEOAS/HAL
Frequently asked questions
Is the TVmaze API free to use?
Yes, TVmaze provides a free, fast, and clean REST API, with an additional user-level API available for Premium members.
What format does the API return data in?
The API returns JSON and conforms to the HATEOAS and HAL principles.
Can I search for shows and people?
Yes, the API includes endpoints for searching shows by name and searching people such as cast and crew.
Does the API support looking up shows by external IDs?
Yes, you can look up shows using their TheTVDB or IMDB ID via the lookup endpoint.
What kind of schedule data is available?
You can retrieve TV schedules by country and date, a separate web/streaming schedule, and a full schedule of all future episodes.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
