{ "openapi": "3.1.0", "info": { "title": "Movies & TV API", "version": "1.0.0", "description": "232,658 movies and TV series from Wikidata, CC0, with IMDb and TMDB ids, cast, genres and runtime.\n\nMovies and TV metadata you can actually license: 232,658 titles — 182,525 films and 50,133 TV series, every one with an English Wikipedia article — from Wikidata, which is CC0 public domain (no TMDB terms, no IMDb licensing). Each title carries year, directors, top cast, genres, countries, original language, runtime, a notability rank and — the feature integrators pay for — the IMDb and TMDB id crosswalk: resolve tt0903747 to Breaking Bad (2008-2013) in one call. Search is token full-text, so \"dark knight\" finds The Dark Knight; filter by director (Hayao Miyazaki returns 25 films led by Spirited Away), actor (Tom Hanks in the 90s: Forrest Gump, Saving Private Ryan), genre, type or year range, all ranked so famous titles surface first. Coverage includes the categories keyword-tagged sources miss — anime, documentaries and animated series are all in, via full subclass traversal. New releases sync daily from Wikidata as they gain Wikipedia articles, and repeat syncs fill in cast and ids as editors add them. Built for streaming guides, watchlist and discovery apps, quizzes, and any product that needs clean movie data without a licensing bill. CC0 source data, self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/movies.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/movies" }, "servers": [ { "url": "https://api-movies.dataandapis.com" } ], "tags": [ { "name": "Entertainment", "description": "Movies & TV API belongs to the Entertainment category of the Data and APIs catalog." } ], "paths": { "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Movies & TV API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/movies/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attribution": "Data from Wikidata (CC0)", "count": 1, "sources": [ { "slug": "wikidata-films", "name": "Wikidata films & TV series (enwiki subset)", "publisher": "Wikidata contributors", "licence": "CC0 1.0 (public domain dedication)", "source_url": "https://www.wikidata.org/", "file_url": "https://query.wikidata.org/sparql", "cadence": "daily new-release refresh", "record_count": 232658, "retrieved_at": "2026-09-05" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/titles/{qid}": { "get": { "operationId": "getTitle", "summary": "Get Title", "description": "Get Title endpoint of the Movies & TV API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/movies/get-title" }, "parameters": [ { "name": "qid", "in": "path", "required": true, "schema": { "type": "string" }, "example": "Q163872" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "title": { "qid": "Q163872", "type": "movie", "title": "The Dark Knight", "description": "2008 film directed by Christopher Nolan", "year": 2008, "end_year": null, "duration_min": 153, "directors": [ "Christopher Nolan" ], "cast": [ "Heath Ledger", "Christian Bale", "Morgan Freeman", "Gary Oldman", "Michael Caine", "Aaron Eckhart", "Maggie Gyllenhaal", "Cillian Murphy", "Eric Roberts", "William Fichtner" ], "genres": [ "drama film", "action film", "crime film", "superhero film", "neo-noir", "thriller film", "crime thriller film" ], "countries": [ "United States", "United Kingdom" ], "original_language": "English", "imdb_id": "tt0468569", "tmdb_id": "155", "wikipedia": "https://en.wikipedia.org/wiki/The_Dark_Knight", "notability_rank": 107 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/titles/imdb/{id}": { "get": { "operationId": "lookupByImdbId", "summary": "Lookup By IMDb ID", "description": "Lookup By IMDb ID endpoint of the Movies & TV API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/movies/lookup-by-imdb-id" }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "example": "tt0903747" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "title": { "qid": "Q1079", "type": "tv_series", "title": "Breaking Bad", "description": "American crime drama television series (2008–2013)", "year": 2008, "end_year": 2013, "duration_min": null, "directors": [ "Vince Gilligan", "Bryan Cranston", "Michelle MacLaren", "David Slade", "Félix Enríquez Alcalá" ], "cast": [ "Bryan Cranston", "Kevin Rankin", "Norbert Weisser", "Jim Beaver", "Jonathan Banks", "Danny Trejo", "Krysten Ritter", "Laura Fraser", "Anna Gunn", "Aaron Paul" ], "genres": [ "drama television series", "crime television series", "black comedy television series", "thriller television series", "contemporary Western film" ], "countries": [ "United States" ], "original_language": "American English", "imdb_id": "tt0903747", "tmdb_id": "1396", "wikipedia": "https://en.wikipedia.org/wiki/Breaking_Bad", "notability_rank": 102 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/titles/random": { "get": { "operationId": "randomTitle", "summary": "Random Title", "description": "Random Title endpoint of the Movies & TV API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/movies/random-title" }, "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "example": "movie" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "title": { "qid": "Q190050", "type": "movie", "title": "Fight Club", "description": "Psychological Drama and Thriller based on the novel “Fight Club” by Chuck Palahniuk", "year": 1999, "end_year": null, "duration_min": 139, "directors": [ "David Fincher" ], "cast": [ "Brad Pitt", "Edward Norton", "Zach Grenier", "Meat Loaf", "Helena Bonham Carter", "Matt Winston", "David Lee Smith", "David Andrews", "Bob Stephenson", "Jared Leto" ], "genres": [ "drama film", "psychological thriller", "thriller film", "flashback film" ], "countries": [ "United States", "Germany" ], "original_language": "English", "imdb_id": "tt0137523", "tmdb_id": "550", "wikipedia": "https://en.wikipedia.org/wiki/Fight_Club", "notability_rank": 102 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/titles": { "get": { "operationId": "searchTitles", "summary": "Search Titles", "description": "Search Titles endpoint of the Movies & TV API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/movies/search-titles" }, "parameters": [ { "name": "actor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "director", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "genre", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "dark knight" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "example": "movie" }, { "name": "year_from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "year_to", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 3, "page": 1, "limit": 20, "count": 3, "results": [ { "qid": "Q163872", "type": "movie", "title": "The Dark Knight", "year": 2008, "end_year": null, "directors": [ "Christopher Nolan" ], "genres": [ "drama film", "action film", "crime film", "superhero film", "neo-noir", "thriller film", "crime thriller film" ], "imdb_id": "tt0468569" }, { "qid": "Q189330", "type": "movie", "title": "The Dark Knight Rises", "year": 2012, "end_year": null, "directors": [ "Christopher Nolan" ], "genres": [ "drama film", "action film", "superhero film", "thriller film", "crime thriller film" ], "imdb_id": "tt1345836" }, { "qid": "Q2709431", "type": "movie", "title": "Batman: The Dark Knight Returns", "year": 2012, "end_year": null, "directors": [ "Jay Oliva" ], "genres": [ "action film", "science fiction film", "dystopian film" ], "imdb_id": null } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }