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
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-06
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.tvmaze.com/v1/auth/validate" \
-H "Accept: application/json"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);import requests
response = requests.request(
"GET",
"https://api.tvmaze.com/v1/auth/validate",
headers={
"Accept": "application/json",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| POST | /auth/poll | Poll whether an authentication request was confirmed |
| POST | /auth/start | Start an authentication request |
| GET | /auth/validate | Validate your authentication credentials |
| POST | /scrobble/episodes | Mark 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/shows | Mark 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/episodes | List 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/networks | List 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/people | List 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/shows | List 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/webchannels | List 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/tags | List all tags |
| POST | /user/tags | Create 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}/shows | List 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/episodes | List 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/shows | List 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.
Similar video APIs
Compare alternatives →Vimeo
VideoBuild something great. Vimeo's API supports flexible, high-quality video integration with your custom apps.
Dailymotion
VideoDailymotion Developer API
TMDb
VideoCommunity-based movie data
The Vampire Diaries
VideoWeb site created using create-react-app
IMDb
VideoAPI for receiving movie, serial and cast information
Czech Television
VideoTV programme of Czech TV
Listed from public-apis (MIT), public-apis database (MIT), Free Public APIs, APIs.guru (CC0).