GET /singlesearch/shows

tvmaze.com:tvmaze-api

Summary: Single show search
Operation ID: singleSearchShows
Auth: none

Search for a single TV show by exact or near-exact name match. Returns exactly one show - the best match for the search query. Unlike /search/shows which returns multiple candidates, this endpoint is designed when you expect exactly one result. Useful for unambiguous show lookups.

Original spec description

Immediately return the most relevant show for a query, or 404 if not found.

Usage Tips

- Returns 404 if no show matches - Returns 422 if multiple shows match equally well - Use 'embed' parameter to include episodes or cast - More strict than the regular search endpoint

Parameters (2)

embed (string, query, optional)

Embed related resources (episodes, cast, nextepisode, previousepisode, etc.)

q (string, query, required)

The search query string

Examples (7)

TitleTypeURLAction
Single search show doc_extracted https://api.tvmaze.com/singlesearch/shows?q=The%20Walking%20Dead
Single search shows doc_extracted https://api.tvmaze.com/singlesearch/shows?q=lost
Search for Game of Thrones curl https://api.tvmaze.com/singlesearch/shows?q=Game%20of%20Thrones
Search for Breaking Bad curl https://api.tvmaze.com/singlesearch/shows?q=Breaking%20Bad
Search for The Office curl https://api.tvmaze.com/singlesearch/shows?q=The%20Office
Single show search openapi-spec https://api.tvmaze.com/singlesearch/shows?q=Game of Thrones&embed=episodes
Single show search probe-gate https://api.tvmaze.com/singlesearch/shows?q=Game+of+Thrones&embed=episodes

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:15:40.663282 200 119ms
2026-03-23 10:10:57.281961 200 108ms
2026-03-23 09:48:04.998461 200 124ms
2026-03-23 09:43:51.385719 200 96ms
2026-03-23 09:05:36.550637 200 82ms
2026-03-23 09:02:21.580688 200 87ms
2026-03-22T09:42:56.552841 200 114ms

Response Changes

WhenOldNew
2026-03-23 09:02:21.580688 6c115f19e13d f9b4ce66945a
2026-03-23 09:05:36.550637 f9b4ce66945a a78aadfe8791
2026-03-23 09:43:51.385719 a78aadfe8791 9d10f2233bae
2026-03-23 09:48:04.998461 9d10f2233bae bf1729895472
2026-03-23 10:10:57.281961 bf1729895472 e9c9c9bc2157
2026-03-23 10:15:40.663282 e9c9c9bc2157 403084abce5a