TV Maze
MediaAdd television information to your own website or app with a fast and clean TV API. Add schedules, show, episode, cast information with free API. It provide a free, fast and clean REST API that's easy to use, returns JSON and conforms to the HATEOAS and HAL principles. The root url is http://api.tvmaze.com and the available endpoints are documented.
📚 Documentation & Examples
Everything you need to integrate with TV Maze
🚀 Quick Start Examples
// TV Maze API Example
const response = await fetch('http://www.tvmaze.com/api', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);Introduction to TVMaze API
Are you looking for a comprehensive TV guide API that provides you with the latest information about the shows you love to watch? Look no further than TVMaze API!
TVMaze API is a RESTful API that lets you access TV show data such as information about episodes, cast, and crew. With its extensive database of shows, it's easy to find detailed information about any TV program you want to know more about.
In this blog post, we'll explore how you can use TVMaze API by showcasing some example code in JavaScript.
Getting Started — No API Key Required
The TVMaze public API is completely free and needs no API key. Just call https://api.tvmaze.com directly. Requests are rate-limited to at least 20 calls every 10 seconds per IP address (exceed it and you get an HTTP 429).
// Search for a show by name
fetch('https://api.tvmaze.com/search/shows?q=the%20office')
.then(r => r.json())
.then(console.log);
// Get a single show plus its episodes
fetch('https://api.tvmaze.com/singlesearch/shows?q=girls&embed=episodes')
.then(r => r.json())
.then(console.log);
// Look up one show by ID
fetch('https://api.tvmaze.com/shows/1')
.then(r => r.json())
.then(console.log);
There is no apikey parameter for the public endpoints — ignore any tutorial that adds one. The only part that requires authentication is the separate user-level API, available to TVMaze Premium members for personal data like followed shows and marked episodes; that uses HTTP Basic auth with your Premium account.
Conclusion
In this blog post, we've seen how you can use TVMaze API to retrieve TV show data using JavaScript. We've explored some example code snippets that demonstrate how you can make requests to TVMaze API and retrieve data about shows, episodes, and more.
If you're looking for a comprehensive TV guide API that provides you with the latest information about your favorite shows, TVMaze API is a great resource to check out.
