Overview
TVMaze API is a free, no-auth-required source of TV show data including schedules, episode details, cast information, and ratings. It is perfect for beginners because you can start making requests immediately without signing up. The API covers thousands of shows and is updated in real time.
Beginner Tip
Use the /search/shows endpoint with a q parameter to find any TV show instantly -- no API key needed. You can also fetch tonight TV schedule with /schedule?country=US&date=YYYY-MM-DD.
Available Data
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.
{
"status": "success",
"data": {
"result": "Data from TVMaze",
"description": "TV Show Data",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
id TVMaze unique identifier for the show. name Name of the TV show. status Current status of the show: Running, Ended, or In Development. rating.average Average user rating for the show on a scale of 0 to 10. network.name Name of the television network that airs the show. summary HTML-formatted plot summary of the show. Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://api.tvmaze.com/search/shows?q=Breaking+Bad";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →An API of Ice And Fire
⭐ Beginner's PickAn API of Ice and Fire is a free, open REST API providing comprehensive data from the Game of Thrones universe, including characters, houses, and books from George R.R.
Breaking Bad Quotes
⭐ Beginner's PickBreaking Bad Quotes is a tiny, free API that returns random quotes from the Breaking Bad TV series.
Final Space
⭐ Beginner's PickThe Final Space API provides data from the animated TV show Final Space, including characters, episodes, and locations — all accessible without an API key.
Dune
⭐ Beginner's PickThe Dune API is a free, no-auth REST API that returns data from the Dune universe including books, characters, movies, and quotes.
IMDbOT
⭐ Beginner's PickIMDbOT is an unofficial, free REST API that provides movie and TV series information sourced from IMDb data — no API key required.