Skip to content
GET /v1/search

Search the show catalogue

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/tvmaze-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/tvmaze-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tvmaze-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tvmaze-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/tvmaze-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 10,
        "query": "breaking",
        "shows": [
            {
                "id": 169,
                "url": "https://www.tvmaze.com/shows/169/breaking-bad",
                "imdb": "tt0903747",
                "name": "Breaking Bad",
                "type": "Scripted",
                "ended": "2019-10-11",
                "image": "https://static.tvmaze.com/uploads/images/medium_portrait/501/1253519.jpg",
                "genres": [
                    "Drama",
                    "Crime",
                    "Thriller"
                ],
                "rating": 9.2,
                "status": "Ended",
                "country": "US",
                "network": "AMC",
                "runtime": 60,
                "summary": "Breaking Bad follows protagonist Walter White, a chemistry teacher who lives in New Mexico with his wife and teenage son who has cerebral palsy. White is diagnosed with Stage III cancer and given a prognosis of two years left to live. With a new sense of fearlessness based on his medical prognosis, and a desire to secure his family's financial security, White chooses to enter a dangerous world of ",
                "language": "English",
                "premiered": "2008-01-20",
                "popularity": 100,
                "official_site": "http://www.amc.com/shows/breaking-bad",
                "premiered_year": "2008"
            },
            {
                "id": 57880,
                "url": "https://www.tvmaze.com/shows/57880/bangkok-breaking",
                "imdb": "tt14202282",
                "name": "Bangkok Breaking",
                "type": "Scripted",
                "ended": null,
                "image": "https://static.tvmaze.com/uploads/images/medium_portrait/360/901524.jpg",
                "genres": [
                    "Drama",
                    "Crime"
                ],
                "rating": null,
                "status": "To Be Determined",
                "country": null,
                "network": "Netflix",
                "runtime": 60,
                "summary": "Newly arrived in Bangkok, Wanchai joins the road rescue service and unravels a city-wide conspiracy with the help of a journalist.",
                "language": "Thai",
                "premiered": "2021-09-23",
                "popularity": 84,
                "official_site": "https://www.netflix.com/title/81287826",
                "premiered_year": "2021"
            },
            {
                "id": 531,
                "url": "https://www.tvmaze.com/shows/531/breaking-amish",
                "imdb": "tt2386354",
                "name": "Breaking Amish",
                "type": "Reality",
                "ended": "2014-11-20",
                "image": "https://static.tvmaze.com/uploads/images/medium_portrait/589/1473736.jpg",
                "genres": [],
                "rating": null,
                "status": "Ended",
                "country": "US",
             
…