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
https://api.tvmaze.com/v1
Auth type
Basic Auth
Auth header
Authorization: Basic BASE64(username:password)
Rate limit
20 req/10s (public) · 200 req/10s (commercial)
Pricing
Enterprise / contact sales
Free quota
None
Documentation
http://www.tvmaze.com
Endpoint status
Server online — HTTP 404 — server is online but path returned an error (may require auth)1.79s
(checked Mar 29, 2026)
Builder score
D
46%
builder-friendly
HTTP Basic Auth — base64-encoded username:password
Authorization: Basic BASE64(username:password)
Free — TVmaze API is free for non-commercial use. TV show database and scheduling. User endpoints require OAuth 2.0. Premium plan $1.99/mo for contributors.
| Method | Path | Description |
|---|---|---|
| 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 |
curl -X GET 'https://api.tvmaze.com/v1/auth/poll' \ -H 'Authorization: Basic BASE64(username:password)'
{}
Data sourced from API Map. Always verify pricing and rate limits against the official TVmaze user documentation.