# TV Shows API > Live TV-show data and what's on the air as an API, served from TVmaze. Look any show up by name or id for its details and popularity — genres, status, runtime, premiere and end dates, the average user rating, TVmaze's popularity weight, the network and country, the official site and a summary. Search the show catalogue, or pull a country's daily broadcast schedule: every episode airing on a given day with its show, season, episode and airtime. The TV-listings, popularity and what's-on layer for entertainment, media and dashboard apps. Live, no key, no cache. Distinct from movie and anime APIs — this is TVmaze's television shows, ratings and schedule. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/tvmaze-api/..." ``` ## Pricing - **Free** (Free) — 11,000 calls/Mo, 5 req/s - **Starter** ($9/Mo) — 135,000 calls/Mo, 15 req/s - **Pro** ($20/Mo) — 700,000 calls/Mo, 40 req/s - **Scale** ($48/Mo) — 3,500,000 calls/Mo, 100 req/s ## Endpoints ### Show #### `GET /v1/show` — A show details, rating and popularity **Parameters:** - `q` (query, optional, string) — Show name Example: `Breaking Bad` - `id` (query, optional, string) — TVmaze show id Example: `169` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tvmaze-api/v1/show?q=Breaking+Bad&id=169" ``` **Response:** ```json { "data": { "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" }, "meta": { "timestamp": "2026-06-09T03:02:02.634Z", "request_id": "3c0ac6ef-f0ba-4c49-b2a0-eebe2b8660a5" }, "status": "ok", "message": "Show retrieved successfully", "success": true } ``` ### Search #### `GET /v1/search` — Search the show catalogue **Parameters:** - `q` (query, required, string) — Search query Example: `breaking` - `limit` (query, optional, string) — Max results (1-25) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tvmaze-api/v1/search?q=breaking&limit=10" ``` **Response:** ```json { "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": "http …(truncated, see openapi.json for full schema) ``` ### Schedule #### `GET /v1/schedule` — A country daily broadcast schedule **Parameters:** - `country` (query, optional, string) — ISO country code Example: `US` - `date` (query, optional, string) — YYYY-MM-DD (default today) Example: `2026-06-09` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tvmaze-api/v1/schedule?country=US&date=2026-06-09" ``` **Response:** ```json { "data": { "date": "2026-06-09", "count": 115, "country": "US", "episodes": [ { "show": "The Story Is with Elex Michaelson", "rating": null, "season": 2026, "airdate": "2026-06-08", "airtime": "00:00", "episode": 111, "network": "CNN", "show_id": 87855, "episode_name": "Episode 111" }, { "show": "Late Night with Seth Meyers", "rating": 4.6, "season": 2026, "airdate": "2026-06-08", "airtime": "00:35", "episode": 60, "network": "NBC", "show_id": 363, "episode_name": "Josh Gad, Andrew Rannells, Hannah Berner" }, { "show": "Way Too Early", "rating": null, "season": 2026, "airdate": "2026-06-09", "airtime": "05:00", "episode": 111, "network": "MS NOW", "show_id": 15308, "episode_name": "Episode 111" }, { "show": "FOX Weather First", "rating": null, "season": 2026, "airdate": "2026-06-09", "airtime": "05:00", "episode": 114, "net …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tvmaze-api/v1/meta" ``` **Response:** ```json { "data": { "source": "TVmaze public API (live)", "service": "tvmaze-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/show": "A show's details and popularity (q=Breaking Bad or id=169).", "GET /v1/search": "Search the show catalogue (q=breaking, limit).", "GET /v1/schedule": "A country's broadcast schedule (country=US, date=YYYY-MM-DD, default today)." }, "description": "Live TV-show data from TVmaze: look a show up by name or id for its genres, status, runtime, premiere/end dates, average user rating, popularity weight, network and country, official site and summary; search the catalogue; or pull a country's daily broadcast schedule (every episode airing with show, episode and airtime). Live, no key. Distinct from movie and anime APIs — this is TVmaze's television shows, ratings and schedule.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-09T03:02:02.978Z", "request_id": "a588e9be-5e43-46e8-aa4c-83a7eac580fc" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/tvmaze-api OpenAPI spec: https://www.oanor.com/api/tvmaze-api/openapi.json