TVmaze
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.
TVmaze publishes 17 APIs on the APIs.io network, including auth API, Episodes API, followed networks API, and 14 more. Tagged areas include Video, Television, Streaming, Schedule, and Metadata.
The TVmaze catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
TVmaze’s developer surface includes authentication, documentation, API reference, signup flow, developer console, pricing, support, and 20 more developer resources.
Kin Score
APIs 17
Individual APIs this provider publishes, each with its own machine-readable definition.
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.
Scroll for all 17
Postman Collections 17
Ready-to-run Postman collections for exercising this provider's APIs.
TVmaze Premium User auth API
POSTMANScroll for all 17
Open Collections 2
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
TVmaze Premium User API
OPEN COLLECTIONTVmaze Public API
OPEN COLLECTIONPricing Plans 1
Published pricing tiers and plan structures.
Tvmaze Plans Pricing
PLANSRate Limits 1
Documented rate limits and quota policies.
Tvmaze Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals for API financial operations.
Tvmaze Finops
FINOPSFeatures 10
Notable capabilities this provider offers.
Free Public API
No API key required for read access to shows, episodes, schedules, cast, crew, people.
Premium User API
HTTP-Basic authenticated user-scoped API for follows, marks, votes, tags, and scrobbling.
Device Auth Pairing
/v1/auth/start + /v1/auth/poll flow lets third-party apps obtain a user's API key without prompting for the password.
External ID Lookup
Resolve a show by TVRage, TheTVDB, or IMDb identifier.
Embedded Related Resources
Use ?embed= to fold cast, episodes, seasons, nextepisode, or previousepisode into a single show response.
Incremental Sync
/updates/shows and /updates/people return timestamp maps for efficient catch-up jobs.
Country-Aware Schedules
/schedule and /schedule/web accept an ISO country code and date to produce localized listings.
Full Future Schedule
/schedule/full returns every known future episode for bulk ingestion (cached 24h).
Bulk Scrobbling
Submit batches of viewing events through /v1/scrobble/episodes — available to free users too.
CC BY-SA Licensed Data
Data is freely usable with attribution to tvmaze.com.
Scroll for all 10
Semantic Vocabularies 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Tvmaze Context
JSON-LDSpectral Rules 2
Spectral governance rulesets for linting and validating these APIs.
TVmaze API Rules
SPECTRALTVmaze API Rules
SPECTRALJSON Schema 32
Standalone JSON Schema definitions for this provider's data models.
BulkResponse
JSON SCHEMAEpisode
JSON SCHEMAEpisodeVote
JSON SCHEMAMarkedEpisode
JSON SCHEMAMarkType
JSON SCHEMANetwork
JSON SCHEMANetworkFollow
JSON SCHEMAPerson
JSON SCHEMAPersonFollow
JSON SCHEMAShow
JSON SCHEMAShowFollow
JSON SCHEMAShowVote
JSON SCHEMATag
JSON SCHEMATagInstance
JSON SCHEMAWebchannel
JSON SCHEMAWebchannelFollow
JSON SCHEMAAka
JSON SCHEMACastCredit
JSON SCHEMACharacter
JSON SCHEMACountry
JSON SCHEMACrewCredit
JSON SCHEMAEpisode
JSON SCHEMAExternals
JSON SCHEMAImage
JSON SCHEMALinks
JSON SCHEMANetwork
JSON SCHEMAPerson
JSON SCHEMARating
JSON SCHEMASchedule
JSON SCHEMASeason
JSON SCHEMAShow
JSON SCHEMAWebChannel
JSON SCHEMAScroll for all 32
JSON Structure 32
JSON Structure definitions describing this provider's data shapes.
Tvmaze Premium Bulkresponse Structure
JSON STRUCTURETvmaze Premium Episode Structure
JSON STRUCTURETvmaze Premium Episodevote Structure
JSON STRUCTURETvmaze Premium Markedepisode Structure
JSON STRUCTURETvmaze Premium Marktype Structure
JSON STRUCTURETvmaze Premium Network Structure
JSON STRUCTURETvmaze Premium Networkfollow Structure
JSON STRUCTURETvmaze Premium Person Structure
JSON STRUCTURETvmaze Premium Personfollow Structure
JSON STRUCTURETvmaze Premium Show Structure
JSON STRUCTURETvmaze Premium Showfollow Structure
JSON STRUCTURETvmaze Premium Showvote Structure
JSON STRUCTURETvmaze Premium Tag Structure
JSON STRUCTURETvmaze Premium Taginstance Structure
JSON STRUCTURETvmaze Premium Webchannel Structure
JSON STRUCTURETvmaze Premium Webchannelfollow Structure
JSON STRUCTURETvmaze Public Aka Structure
JSON STRUCTURETvmaze Public Castcredit Structure
JSON STRUCTURETvmaze Public Character Structure
JSON STRUCTURETvmaze Public Country Structure
JSON STRUCTURETvmaze Public Crewcredit Structure
JSON STRUCTURETvmaze Public Episode Structure
JSON STRUCTURETvmaze Public Externals Structure
JSON STRUCTURETvmaze Public Image Structure
JSON STRUCTURETvmaze Public Links Structure
JSON STRUCTURETvmaze Public Network Structure
JSON STRUCTURETvmaze Public Person Structure
JSON STRUCTURETvmaze Public Rating Structure
JSON STRUCTURETvmaze Public Schedule Structure
JSON STRUCTURETvmaze Public Season Structure
JSON STRUCTURETvmaze Public Show Structure
JSON STRUCTURETvmaze Public Webchannel Structure
JSON STRUCTUREScroll for all 32
Examples 16
Example request and response payloads for these APIs.
Public Get Episode Example
EXAMPLEPublic Get Person Example
EXAMPLEPublic Get Season Example
EXAMPLEPublic Get Show Example
EXAMPLETvmaze Public Image Example
EXAMPLETvmaze Public Person Example
EXAMPLETvmaze Public Rating Example
EXAMPLETvmaze Public Season Example
EXAMPLETvmaze Public Show Example
EXAMPLEScroll for all 16
Security Posture 2
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
Recommended x-agentic-access execution contracts for AI agents.
Use Cases 6
What developers build with this provider.
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.
Integrations 6
Pre-built integrations with other platforms and tools.
Trakt.tv
Many Trakt-style workflows mirror TVmaze IDs and metadata.
Plex / Kodi / Emby
Media-center plugins read TVmaze metadata for show artwork, episode info, and airdates.
Stremio
Stremio addons (e.g. tvmaze-addon) surface TVmaze schedules in the catalog UI.
Sonarr / Radarr family
Several PVR ecosystems consume TVmaze as a fallback metadata provider.
Model Context Protocol (MCP)
Community MCP servers (mcp-tvmaze, tvmaze-mcp-server, 3cat-tvmaze-mcp) expose TVmaze as agent tools.
Apify TVmaze Scraper
Apify hosts a TVmaze scraper actor with its own OpenAPI definition.
Solutions 5
Packaged solutions this provider offers.
Free Personal Use
Anonymous public API for hobby projects, dashboards, and personal calendars.
Premium Bronze
Entry-tier subscription unlocking the user API and tracking features.
Premium Silver
Adds custom iCal and RSS calendar feeds.
Premium Gold
Tops the tier with influence over feature development.
Enterprise / Commercial
Custom commercial licensing for high-volume or redistributive use beyond CC BY-SA personal use.
Resources
Get Started 3
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 3
Pagination, idempotency, versioning, errors, and events
Build 4
SDKs, sample code, and the tooling you integrate with
Access & Security 2
Authentication, authorization, and security posture
Operate 4
Status, limits, changes, and where to get help
Commercial 7
Pricing, plans, and the legal terms of use
Scroll for all 7
Company 2
The organization behind the API