GET /lookup/shows

tvmaze.com:tvmaze-api

Summary: Lookup show by external ID
Operation ID: lookupShow
Auth: none

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.

Original spec description

Find a show using external IDs from TVRage, TVDB, or IMDB. Returns HTTP 301 redirect to the show page.

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 (with tt prefix)

thetvdb (integer, query, optional)

TheTVDB ID

tvrage (integer, query, optional)

TVRage ID

Examples (7)

TitleTypeURLAction
Lookup show by TVDB ID doc_extracted https://api.tvmaze.com/lookup/shows?thetvdb=79349
Lookup show by TVRage ID doc_extracted https://api.tvmaze.com/lookup/shows?tvrage=7926
Lookup show by IMDB ID doc_extracted https://api.tvmaze.com/lookup/shows?imdb=tt3107288
Lookup by TVRage ID doc_extracted https://api.tvmaze.com/lookup/shows?tvrage=33272
Lookup show by IMDB ID curl https://api.tvmaze.com/lookup/shows?imdb=tt0944947
Lookup show by TheTVDB ID curl https://api.tvmaze.com/lookup/shows?thetvdb=121361
Lookup show by external ID openapi-spec https://api.tvmaze.com/lookup/shows?imdb=tt0903747

Probe History

Latency

Status Codes

TimeStatusLatencySize
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
2026-03-23 09:25:13.905703 200 108ms
2026-03-23 09:23:55.637588 200 132ms

Response Changes

WhenOldNew
2026-03-23 09:25:13.905703 518205216a17 9d10f2233bae
2026-03-23 09:39:11.585764 9d10f2233bae 075c1ea1b6d2
2026-03-23 10:21:56.404715 075c1ea1b6d2 403084abce5a
2026-03-23 10:26:00.350131 403084abce5a 0bc28ae3f72e
2026-03-23 10:38:03.654235 0bc28ae3f72e 9d10f2233bae
2026-03-23 10:45:37.618905 9d10f2233bae 0bc28ae3f72e