# TVmaze

**Canonical:** https://apis.io/providers/tvmaze/  
**Website:** https://www.tvmaze.com  
**APIs profiled:** 17

TVmaze is a community-driven TV show database that publishes a free RESTful API for TV show, episode, season, cast, crew, and broadcast/streaming schedule data. The public API is anonymous, CORS-enabled, and licensed under CC BY-SA 4.0. A paid Premium subscription unlocks a separate user-scoped API for managing follows, votes, marks, tags, and scrobbling.

## Kin Score — 56.2 / 100 (strong)

Scored 2026-08-25 under rubric 0.14.0. Trend: flat (+0.0 from 56.2).

| Facet | Score |
|---|---|
| Discoverability | 57.4 |
| Contract Quality | 61.7 |
| Governance | 28.8 |
| Contract Governance | 28.8 |
| Operational Transparency | 39.5 |
| Developer Ergonomics | 54.8 |
| Commercial Clarity | 77.6 |
| Access Clarity | 77.6 |

## Agent readiness — 28.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | partial |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## Access

Paid · Self-serve signup — onboarding: self-serve, pricing: paid, trial: no (confidence: high).

## APIs (17)

- **TVmaze auth API** — The auth API from TVmaze — 3 operation(s) for auth.
- **TVmaze Episodes API** — Individual episode details including guest cast and crew.
- **TVmaze followed networks API** — The followed networks API from TVmaze — 2 operation(s) for followed networks.
- **TVmaze followed people API** — The followed people API from TVmaze — 2 operation(s) for followed people.
- **TVmaze followed shows API** — The followed shows API from TVmaze — 2 operation(s) for followed shows.
- **TVmaze followed webchannels API** — The followed webchannels API from TVmaze — 2 operation(s) for followed webchannels.
- **TVmaze marked episodes API** — The marked episodes API from TVmaze — 2 operation(s) for marked episodes.
- **TVmaze People API** — Person profiles, cast credits, and crew credits.
- **TVmaze Schedule API** — Daily and rolling TV and web/streaming schedules.
- **TVmaze scrobbling API** — The scrobbling API from TVmaze — 4 operation(s) for scrobbling.
- **TVmaze Search API** — Free-text search and lookup endpoints for shows and people.
- **TVmaze Seasons API** — Season-level metadata and episode listings.
- **TVmaze Shows API** — Show metadata, episodes, seasons, cast, crew, images, and aliases.
- **TVmaze tagged shows API** — The tagged shows API from TVmaze — 4 operation(s) for tagged shows.
- **TVmaze Updates API** — Bulk timestamps useful for incremental sync of shows and people.
- **TVmaze voted episodes API** — The voted episodes API from TVmaze — 2 operation(s) for voted episodes.
- **TVmaze voted shows API** — The voted shows API from TVmaze — 2 operation(s) for voted shows.

## Agentic access (1)

- **Tvmaze Agentic Access** — 72 operations · 24 acting

## Security (2)

- **Tvmaze Authentication** — http · 1 scheme
- **Tvmaze Domain Security** — TLSv1.3 · HSTS

## Plans (1)

- **Tvmaze Plans Pricing**

## Use cases (6)

- **TV Calendar Apps** — Build a personal TV calendar driven by /schedule and Premium /v1/user/follows/shows.
- **Streaming Discovery** — Power show search and recommendation flows with /search/shows and ?embed= calls.
- **Media Center Integrations** — Sync show, episode, and image metadata into Plex, Kodi, Emby, Jellyfin, or Stremio plugins.
- **Trakt-Style Scrobblers** — Use /v1/scrobble/episodes to record viewing history from media players.
- **AI Agents and Chatbots** — Front the public API through MCP servers (e.g. mcp-tvmaze) to give LLM agents structured TV knowledge.
- **Data Science / Research** — Bulk-ingest /shows, /people, and /schedule/full pages for analytics and ML training.

## Tags

Video, Television, Streaming, Schedule, Metadata, Entertainment, Public APIs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/tvmaze/). Scores are computed from the provider's own public artifacts under a published rubric.