shows: Lookup show by external ID

API: tvmaze.com:tvmaze-api
Endpoint: /lookup/shows
Response format: application/json
Charset: utf-8
Auth: none
Method: GET
Last Status: 200
Latency: 175ms

Description

Look up a show using an external ID from another database. Supports lookups by IMDB ID, TVDB ID, TVRage ID, and others. This is the bridge endpoint for cross-referencing shows when you have IDs from other TV databases.

From spec: Find a show using IMDB, TVDB, or TVRage ID. Returns HTTP 301 redirect to the show.

Usage Tips

- Must specify exactly one lookup parameter - Supported: imdb, tvdb, tvrage, thetvdb - Returns 404 if not found in TVmaze - Returns 422 if multiple parameters provided

Parameters (3)

imdb (string, query, optional)

IMDB ID (e.g., tt0944947)

thetvdb (integer, query, optional)

TheTVDB ID

tvrage (integer, query, optional)

TVRage ID

Examples (7)

Lookup show by TVDB ID doc_extracted

Demonstrates calling /lookup/shows

curl 'https://api.tvmaze.com/lookup/shows?thetvdb=79349'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'thetvdb': '79349',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", thetvdb=79349)

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?thetvdb=79349");
const data = await resp.json();
Lookup show by TVRage ID doc_extracted

Demonstrates calling /lookup/shows

curl 'https://api.tvmaze.com/lookup/shows?tvrage=7926'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'tvrage': '7926',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", tvrage=7926)

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?tvrage=7926");
const data = await resp.json();
Lookup show by IMDB ID doc_extracted

Look up show by IMDB ID tt3107288

curl 'https://api.tvmaze.com/lookup/shows?imdb=tt3107288'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'imdb': 'tt3107288',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", imdb="tt3107288")

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?imdb=tt3107288");
const data = await resp.json();
Lookup by TVRage ID doc_extracted

Demonstrates calling /lookup/shows

curl 'https://api.tvmaze.com/lookup/shows?tvrage=33272'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'tvrage': '33272',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", tvrage=33272)

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?tvrage=33272");
const data = await resp.json();
Lookup show by IMDB ID curl

Look up show by IMDB ID tt0944947

curl 'https://api.tvmaze.com/lookup/shows?imdb=tt0944947'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'imdb': 'tt0944947',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", imdb="tt0944947")

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?imdb=tt0944947");
const data = await resp.json();
Lookup show by TheTVDB ID curl

Demonstrates calling /lookup/shows

curl 'https://api.tvmaze.com/lookup/shows?thetvdb=121361'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'thetvdb': '121361',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", thetvdb=121361)

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?thetvdb=121361");
const data = await resp.json();
Lookup show by external ID openapi-spec
curl 'https://api.tvmaze.com/lookup/shows?imdb=tt0903747'
import requests

resp = requests.get(
    "https://api.tvmaze.com/lookup/shows",
    params={
        'imdb': 'tt0903747',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("lookup/shows", imdb="tt0903747")

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/lookup/shows?imdb=tt0903747");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:48:05.040548 200 175ms
2026-04-16 17:30:45.631731 200 729ms
2026-04-16 17:19:37.956109 200 295ms
2026-04-16 04:06:59.027521 200 130ms
2026-04-16 03:50:05.083627 200 137ms
2026-04-16 03:34:31.369557 200 210ms
2026-04-16 03:29:29.647196 200 175ms
2026-04-16 02:49:26.695590 200 210ms
2026-04-16 02:27:06.027540 200 180ms
2026-04-16 01:26:31.569877 200 167ms
2026-04-15 03:18:12.617922 200 152ms
2026-04-15 03:08:01.259878 200 191ms
2026-04-15 02:28:42.171049 200 147ms
2026-04-15 01:29:31.064456 200 194ms
2026-04-15 00:36:54.693383 200 186ms
2026-04-15 00:30:43.492416 200 194ms
2026-04-15 00:08:18.814176 200 212ms
2026-04-14 04:09:46.639300 200 183ms
2026-04-14 03:33:57.625255 200 194ms
2026-04-14 03:14:13.689513 200 176ms
2026-04-14 03:13:12.163941 200 134ms
2026-04-14 03:11:35.776191 200 135ms
2026-04-14 02:07:06.194177 200 197ms
2026-04-14 00:10:50.502906 200 650ms
2026-04-12 16:52:39.285130 200 167ms
2026-04-12 15:58:26.895755 200 166ms
2026-04-12 15:53:31.508658 200 216ms
2026-04-12 14:14:40.535330 200 172ms
2026-04-12 13:32:52.519701 200 153ms
2026-04-12 13:27:01.901594 200 149ms
2026-04-12 12:57:00.658404 200 156ms
2026-04-10 06:43:01.400424 200 160ms
2026-04-10 05:11:21.807379 200 118ms
2026-04-10 02:45:27.480451 200 164ms
2026-04-10 01:29:47.230027 200 396ms
2026-04-10 01:04:23.109540 200 115ms
2026-04-10 00:55:54.999428 200 117ms
2026-04-10 00:12:15.927643 200 121ms
2026-04-09 03:49:20.463619 200 126ms
2026-04-09 03:41:10.691959 200 186ms
2026-04-09 03:23:42.345342 200 132ms
2026-04-09 03:20:26.266872 200 167ms
2026-04-09 02:58:19.830037 200 342ms
2026-04-09 02:47:38.878479 200 230ms
2026-04-09 01:46:40.484323 200 473ms
2026-03-23 10:45:37.618905 200 110ms
2026-03-23 10:38:03.654235 200 122ms
2026-03-23 10:26:00.350131 200 111ms
2026-03-23 10:21:56.404715 200 116ms
2026-03-23 09:39:11.585764 200 114ms