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.

agent ready

Solid contracts, transparent operations, and an easy start — typically complete on four or five facets with one clear soft spot.

travel_explore apis.io index code GitHub source public Website

API Evangelist profiles TVmaze the way a machine reads it — 135 machine-readable artifacts across 17 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — TVmaze scores 66.5/100 (strong), with a separate agent-readiness read of 48/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5

Composite quality — 66.5/100 · strong

Contract Quality 18.2 / 25

Developer Ergonomics 9.1 / 20

Commercial Clarity 16.8 / 20

Operational Transparency 2.7 / 13

Governance 10.4 / 12

Discoverability 9.3 / 10

Agent readiness — 48/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

How we profile TVmaze

Each block below is one kind of artifact we hold for TVmaze. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 17

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

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 within the panel for all 17 ·

Open Collections 2

Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

TVmaze Premium User API

OPEN COLLECTION

TVmaze Public API

OPEN COLLECTION

Pricing Plans 1

Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.

Published pricing tiers and plan structures.

Tvmaze Plans Pricing

5 plans

PLANS

Rate Limits 1

Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.

Documented rate limits and quota policies.

Tvmaze Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.

Cost, billing, and metering signals for API financial operations.

Tvmaze Finops

FINOPS

Features 10

The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.

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 within the panel for all 10 ·

Semantic Vocabularies 1

JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.

JSON-LD contexts and semantic vocabularies used across these APIs.

Tvmaze Context

44 classes · 13 properties

JSON-LD

12 properties

JSON SCHEMA

Show

23 properties

JSON SCHEMA

WebChannel

Tvmaze Public Show Example

23 fields

EXAMPLE

Scroll within the panel for all 16 ·

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Tvmaze Authentication

http · 1 scheme

SECURITY

Tvmaze Domain Security

TLSv1.3 · HSTS

SECURITY

Agentic Access 1

An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.

Recommended x-agentic-access execution contracts for AI agents.

Tvmaze Agentic Access

72 operations · 24 acting

AGENTIC

Use Cases 6

What developers actually build with this provider — captured so the catalogue answers 'what is this for', not just 'what does this expose'.

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 tell you where this provider already fits in a stack.

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 the provider offers on top of the raw API surface.

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

Every other property we hold for TVmaze — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Get Started 3

Portal, sign-up, and the first successful call

Signup

Signup

Login

Console

Console

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRules

SpectralRules

Vocabulary

Vocabulary

JSONLD

JSONLD

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Python TVmaze SDK (community, maintained by the TVmaze GitHub org)

SDKs

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 4

Status, limits, changes, and where to get help

RateLimits

Support

FAQ

ChangeLog

Commercial 7

Pricing, plans, and the legal terms of use

Pricing

Plans

FinOps

TermsOfService

PrivacyPolicy

Legal

DataPrivacy

Scroll within the panel for all 7 ·

Company 2

The organization behind the API

Website

Website

Blog

Blog

← All providers · Data indexed from github.com/api-evangelist/tvmaze · machine-readable index on apis.io