TVmaze API

TV and streaming shows, episodes, daily schedules, cast and crew from TVmaze as clean JSON.

The API.SH TVmaze API returns TVmaze's TV database as structured JSON. Search shows or people by name, open a show by TVmaze, IMDb or TheTVDB id for its seasons, cast, crew, network or streaming service and next episode, list every episode with air dates and ratings, read the day's schedule for broadcast TV in a country or for streaming services, and look up people with their cast and crew credits. TVmaze data is CC BY-SA 4.0: credit tvmaze.com when you republish it.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

TVmaze search

GET https://api.api.sh/tvmaze/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the TVmaze API

TV guide and schedule apps

Pull what airs today on broadcast TV in the UK, US or another country, or on streaming services, with full show details.

/schedule

Episode trackers

List every episode of a show with season, number, air date and runtime, and show the next episode in a watchlist app.

/episodes /show

ID mapping and media libraries

Look up a show by IMDb or TheTVDB id to get its TVmaze record and external ids for a media server or catalog.

/show /search

Cast and crew research

Find a person and list their cast and crew credits, or read a show's cast with characters.

/person /search /show

TV answers for AI agents

Let an AI agent answer 'when is the next episode' or 'what's on tonight' from live TVmaze data.

/search /show /schedule

TVmaze data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

TVmaze API endpoints and prices

Every TVmaze endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

TVmaze search

/tvmaze/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

TVmaze person

/tvmaze/v1/person

$1 · $2 PAYG

1 credit

Posts and media1

TVmaze episodes

/tvmaze/v1/episodes

$1 · $2 PAYG

1 credit

More data2

TVmaze TV schedule /tvmaze/v1/schedule	$1 · $2 PAYG 1 credit
TVmaze show /tvmaze/v1/show	$1 · $2 PAYG 1 credit

Call the TVmaze API

TVmaze search: GET https://api.api.sh/tvmaze/v1/search

curl "https://api.api.sh/tvmaze/v1/search?q=breaking+bad" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/tvmaze/v1/search",
    params={"q": "breaking bad"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/tvmaze/v1/search");
url.searchParams.set("q", "breaking bad");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/tvmaze/v1/search", "q", "breaking bad")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "TVmaze" and "TVmaze search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for TVmaze data

Public data only: no TVmaze login, cookies or account needed
One key and one response shape for TVmaze and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official TVmaze API

Yes. TVmaze has a free public API that needs no key, with rate limits and CC BY-SA attribution. If that is all you need, use it directly. API.SH is useful when you want TVmaze through the same key, SDKs, Sheets, Zapier, n8n and MCP tools as your other data, with retries handled for you.

If you already use API.SH, adding TVmaze means no new client code; if not, TVmaze's own free API is a good choice too.

TVmaze API questions

What TVmaze data can I get?+

Show and people search (/tvmaze/v1/search), full show records by TVmaze, IMDb or TheTVDB id (/tvmaze/v1/show), episode lists (/tvmaze/v1/episodes), daily TV and streaming schedules (/tvmaze/v1/schedule) and people with their credits (/tvmaze/v1/person).

How much does the TVmaze API cost?+

Every TVmaze endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /tvmaze/v1/episodes at 1 credit each.

Is the official TVmaze API free?+

Yes. TVmaze's public API is free and keyless, with rate limits. API.SH charges per call because it adds one key and one response format shared with every other API.SH platform, plus SDKs and no-code integrations.

Do I need a TVmaze API key or account?+

No. You only need your API.SH key. A TVmaze key is only needed for TVmaze's premium user-level API, which API.SH does not cover.

Can I republish TVmaze data?+

Yes, under its CC BY-SA 4.0 license: credit tvmaze.com wherever you show the data.

TVmaze or TMDB?+

TVmaze is built for TV: episodes, air dates, networks and daily schedules by country. If you need TV schedules and episode data, TVmaze is a strong fit.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /tvmaze/v1/search with q=breaking bad. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.