Skip to content

TVMaze API

by tvmaze.com

No authVideo
Open documentation ↗

Overview

Add television information to your own website or app with a fast and clean TV API. Add schedules, show, episode, cast information, ...

TVMaze is a video API from tvmaze.com. It needs no API key. It is served over plain HTTP. Its OpenAPI description documents 42 endpoints.

At a glance

Authentication
No auth
HTTPS
No
CORS
Unknown
Category
Video
Base URL
https://api.tvmaze.com/v1
Version
1.0
Endpoints
42
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.tvmaze.com/v1/auth/validate" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://api.tvmaze.com/v1/auth/validate", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.tvmaze.com/v1/auth/validate",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
POST/auth/pollPoll whether an authentication request was confirmed
POST/auth/startStart an authentication request
GET/auth/validateValidate your authentication credentials
POST/scrobble/episodesMark episodes as acquired or watched based on their IDs
PUT/scrobble/episodes/{episode_id}Mark an episode as acquired or watched based on its ID
POST/scrobble/showsMark episodes within a show as acquired or watched based on their attributes
GET/scrobble/shows/{show_id}List watched and acquired episodes for a show
GET/user/episodesList the marked episodes
GET/user/episodes/{episode_id}Check if an episode is marked
PUT/user/episodes/{episode_id}Mark an episode
DELETE/user/episodes/{episode_id}Unmark an episode
GET/user/follows/networksList the followed networks
GET/user/follows/networks/{network_id}Check if a network is followed
PUT/user/follows/networks/{network_id}Follow a network
DELETE/user/follows/networks/{network_id}Unfollow a network
GET/user/follows/peopleList the followed people
GET/user/follows/people/{person_id}Check if a person is followed
PUT/user/follows/people/{person_id}Follow a person
DELETE/user/follows/people/{person_id}Unfollow a person
GET/user/follows/showsList the followed shows
GET/user/follows/shows/{show_id}Check if a show is followed
PUT/user/follows/shows/{show_id}Follow a show
DELETE/user/follows/shows/{show_id}Unfollow a show
GET/user/follows/webchannelsList the followed webchannels
GET/user/follows/webchannels/{webchannel_id}Check if a webchannel is followed
PUT/user/follows/webchannels/{webchannel_id}Follow a webchannel
DELETE/user/follows/webchannels/{webchannel_id}Unfollow a webchannel
GET/user/tagsList all tags
POST/user/tagsCreate a new tag
PATCH/user/tags/{tag_id}Update a specific tag
DELETE/user/tags/{tag_id}Delete a specific tag
GET/user/tags/{tag_id}/showsList all shows under this tag
PUT/user/tags/{tag_id}/shows/{show_id}Tag a show
DELETE/user/tags/{tag_id}/shows/{show_id}Untag a show
GET/user/votes/episodesList the episodes voted for
GET/user/votes/episodes/{episode_id}Check if an episode is voted for
PUT/user/votes/episodes/{episode_id}Vote for an episode
DELETE/user/votes/episodes/{episode_id}Remove an episode vote
GET/user/votes/showsList the shows voted for
GET/user/votes/shows/{show_id}Check if a show is voted for
PUT/user/votes/shows/{show_id}Vote for a show
DELETE/user/votes/shows/{show_id}Remove a show vote

Questions

Does the TVMaze API need an API key?

No. The TVMaze API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the TVMaze API support HTTPS?

The TVMaze API is listed as HTTP only, so avoid sending secrets to it.

How many endpoints does the TVMaze API have?

Its OpenAPI description lists 42 endpoints in version 1.0. All of them are shown on this page.

What are alternatives to the TVMaze API?

Other Video APIs include Vimeo, Dailymotion, TMDb, The Vampire Diaries, IMDb.

Compare alternatives →

Listed from public-apis (MIT), public-apis database (MIT), Free Public APIs, APIs.guru (CC0).