# Movies & TV API > Search TV shows and movies, then fetch full details (genres, rating, network, summary, IMDb id, artwork), the complete episode guide and the cast for any title. Powered by TVMaze. ## 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/movies-api/..." ``` ## Pricing - **Free** (Free) — 2,000 calls/Mo, 2 req/s - **Basic** ($15/Mo) — 40,000 calls/Mo, 10 req/s - **Pro** ($49/Mo) — 200,000 calls/Mo, 20 req/s - **Mega** ($129/Mo) — 800,000 calls/Mo, 40 req/s ## Endpoints ### Shows #### `GET /v1/cast` — Cast for a show **Parameters:** - `id` (query, required, string) — Numeric show id Example: `169` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/movies-api/v1/cast?id=169" ``` **Response:** ```json { "data": { "cast": [ { "person_id": 14245, "person_name": "Bryan Cranston", "person_image": "https://static.tvmaze.com/uploads/images/original_untouched/195/488839.jpg", "character_name": "Walter White", "person_country": "United States" }, { "person_id": 12328, "person_name": "Aaron Paul", "person_image": "https://static.tvmaze.com/uploads/images/original_untouched/264/660079.jpg", "character_name": "Jesse Pinkman", "person_country": "United States" }, { "person_id": 11207, "person_name": "Anna Gunn", "person_image": "https://static.tvmaze.com/uploads/images/original_untouched/2/6596.jpg", "character_name": "Skyler White", "person_country": "United States" }, { "person_id": 31023, "person_name": "RJ Mitte", "person_image": "https://static.tvmaze.com/uploads/images/original_untouched/3/8601.jpg", "character_name": "Walter White Jr.", "person_country": "United States" }, { "person_id": 9, "person_name": "Dean Norris", "person_image": "https://static.tvmaze.com/uploads/images/original_untouched/461 …(truncated, see openapi.json for full schema) ``` #### `GET /v1/episodes` — Episode guide for a show **Parameters:** - `id` (query, required, string) — Numeric show id Example: `169` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/movies-api/v1/episodes?id=169" ``` **Response:** ```json { "data": { "count": 62, "show_id": 169, "episodes": [ { "id": 12192, "name": "Pilot", "image": "https://static.tvmaze.com/uploads/images/original_untouched/405/1012681.jpg", "number": 1, "rating": 8.2, "season": 1, "airdate": "2008-01-20", "runtime": 60, "summary": "A high-school chemistry teacher (Bryan Cranston) is diagnosed with a deadly cancer, so he puts his expertise to use and teams with an ex-student (Aaron Paul) to manufacture top-grade crystal meth in hopes of providing for his family after he's gone." }, { "id": 12193, "name": "Cat's in the Bag...", "image": "https://static.tvmaze.com/uploads/images/original_untouched/405/1012682.jpg", "number": 2, "rating": 7.9, "season": 1, "airdate": "2008-01-27", "runtime": 60, "summary": "After the accident in the desert, Walter and Jesse need to dispose of the unfortunate mess in their rolling lab of an RV, and Skyler begins to suspect that Walter and Jesse are involved in some mysterious goings-on." }, { "id": 12194, "name": "...and the Bag's in the River", "image": "https://static.tvmaze.com/uploads/images/ …(truncated, see openapi.json for full schema) ``` #### `GET /v1/search` — Search shows by name **Parameters:** - `q` (query, required, string) — Show or movie name Example: `breaking bad` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/movies-api/v1/search?q=breaking+bad" ``` **Response:** ```json { "data": { "count": 8, "query": "breaking bad", "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/original_untouched/501/1253519.jpg", "score": 1.1960709, "genres": [ "Drama", "Crime", "Thriller" ], "rating": 9.2, "status": "Ended", "country": "United States", "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 drugs and crime and ascends to power in this world. The series explores how a fatal diagnosis such as White's releases a typical man from the daily concerns and constraints of normal society and follows his transformation from mild family man to a kingpin of the drug …(truncated, see openapi.json for full schema) ``` #### `GET /v1/show` — Show details by id **Parameters:** - `id` (query, required, string) — Numeric show id Example: `169` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/movies-api/v1/show?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/original_untouched/501/1253519.jpg", "genres": [ "Drama", "Crime", "Thriller" ], "rating": 9.2, "status": "Ended", "country": "United States", "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 drugs and crime and ascends to power in this world. The series explores how a fatal diagnosis such as White's releases a typical man from the daily concerns and constraints of normal society and follows his transformation from mild family man to a kingpin of the drug trade.", "language": "English", "premiered": "2008-01-20", "official_site": "http://www.amc.com/shows/breaking-bad" }, "meta": { "timestamp": "2026-05-29T23:38:22.530Z", "request_id": "29efa7d3-2332-462b-86e6-6b3dce885 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/movies-api OpenAPI spec: https://www.oanor.com/api/movies-api/openapi.json