TV Show Data
Last verified: November 12, 2026
100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 653 ms.
From TVMaze's OpenAPI specification (version 1.0), spec updated March 6, 2023, via APIs.guru.
Access to the user API is only possible for users with a premium account. A user can only access their own user data. Authentication uses HTTP Basic. Use the TVmaze username as authentication username, and the TVmaze API key as authentication password. Your API key can be found on your dashboard. To try out these API calls from this page, click the "Authorize" button on top and input your credentials.
Buy me a coffee
https://api.tvmaze.com/v1| 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 |
Showing 25 of 42 endpoints. The full list is in the spec above.