Movie and TV catalog enrichment
Use TMDB endpoints to turn movie and tv catalog enrichment into repeatable API requests with documented inputs and JSON responses.
Turn public The Movie Database (TMDB) pages into structured film and TV data — multi-type search across movies, shows, and people, movie and TV detail with overview and release dates, person detail, and curated movie/TV lists as normalized JSON for catalogs, recommendation, and enrichment. Credential-free.
Extract TMDB movie, TV show, and person data — search, detail, and curated lists — as structured JSON from public The Movie Database pages.
Endpoint families
6
Documented params
48
Examples
9
Live catalog snapshot
Active endpoints
9
Methods
GET
Required params
14
Schema refs
9
{
"platform": "TMDB",
"endpoint": "tmdb-search",
"method": "GET",
"path": "/tmdb/search",
"auth": "apiKey"
}Use cases
Extract TMDB movie, TV show, and person data — search, detail, and curated lists — as structured JSON from public The Movie Database pages.
Use TMDB endpoints to turn movie and tv catalog enrichment into repeatable API requests with documented inputs and JSON responses.
Use TMDB endpoints to turn cast and crew (person) metadata collection into repeatable API requests with documented inputs and JSON responses.
Use TMDB endpoints to turn curated list and discovery feeds into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live TMDB endpoint catalog — 9 endpoints, 48 documented request parameters, and 9 published response schemas — the same catalog Docs and Playground run against.
9 documented TMDB endpoints, grouped into 6 request families — Movie, Person and Tv, plus 3 more.
48 request parameters are documented across those TMDB endpoints, 14 of them required — the full input contract is public before you write any integration code.
9 of the 9 TMDB endpoints ship a recorded example response, and 9 carry a documented response schema — you can code against the real JSON before the first request.
TMDB endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
9 hosted MCP tools back the TMDB endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/tmdb/movie/{id}
/tmdb/person/{id}
/tmdb/tv/{id}
/tmdb/collection/{id}
/tmdb/genres
/tmdb/search
Endpoint catalog
/tmdb/searchSearches TMDB movies, TV shows, people, and collections. An unscoped query interleaves results across all four types rather than returning whichever type happens to rank first.
Sampled 14 Oct 2026: 20 items, 4 fields filled in every item, 2 not. type: movie (11), tv (8), person (1); title: “Inception” and 15 other values.
MCP tool tmdb_search
/tmdb/movie/{id}Returns a TMDB movie: overview, tagline, genres, countries, runtime, budget/revenue, top-billed cast, top crew (director/writer), and aggregate rating.
Sampled 14 Oct 2026: 9 items, 3 fields filled in every item. name: “Leonardo DiCaprio” and 8 other values; character: “Dom Cobb” and 8 other values.
MCP tool tmdb_movie
/tmdb/tv/{id}Returns a TMDB TV show: overview, tagline, genres, countries, episode count, first/last air year, top-billed cast, top crew (creator), and aggregate rating.
Sampled 14 Oct 2026: 9 items, 3 fields filled in every item. name: “Bryan Cranston” and 8 other values; character: “Walter White” and 8 other values.
MCP tool tmdb_tv
/tmdb/movie/listReturns a page of TMDB movies from the `category` chart (`popular` by default, or `top_rated`, `now_playing`, `upcoming`), optionally refined by `sort_by`, `with_genres`, `original_language`, release dates, rating, votes and runtime. `limit` defaults to 10 (max 20). Each movie has id, title, overview, poster, release date and `uri`; `has_next_page` signals more pages.
Sampled 14 Oct 2026: 20 items, 3 fields filled in every item. title: “Spider-Man: Brand New Day” and 19 other values; uri: themoviedb.org.
MCP tool tmdb_movie_list
/tmdb/tv/listReturns a page of TMDB TV shows from the `category` chart (`popular` by default, or `top_rated`, `airing_today`, `on_the_air`), optionally refined by `sort_by`, `with_genres`, `original_language`, first-air-date bounds `date_from` and `date_to`, rating, votes and runtime. `limit` defaults to 10 (max 20). A filtered page with no matches returns an empty `shows` array.
Sampled 14 Oct 2026: 20 items, 3 fields filled in every item. title: “Watch What Happens Live with Andy Cohen” and 19 other values; uri: themoviedb.org.
MCP tool tmdb_tv_list
/tmdb/person/{id}Returns a TMDB person by `id`: name, biography, birth date, photo URL and a filmography of movie and TV credits, most prominent first. `limit` caps the credits (default 10, max 20). Each credit has its `type` (`movie` or `tv`), id, title and `uri`. The biography may include a Wikipedia CC-BY-SA attribution note.
Sampled 14 Oct 2026: 8 items, 4 fields filled in every item. uri: themoviedb.org.
MCP tool tmdb_person
/tmdb/collection/{id}Returns a TMDB collection (a movie franchise grouping) by `id`, which can be the collection id or an id-slug. The response has the collection title, overview, `uri` and `source_url`, plus its member movies, each with id, title, overview, poster URL, release date and `uri`.
Sampled 14 Oct 2026: 3 items, 3 fields filled in every item. title: “Batman Begins” and 2 other values; uri: themoviedb.org.
MCP tool tmdb_collection
/tmdb/genresReturns every genre ID for TMDB movie and TV browse pages. Use movie values only with movie list filters and TV values only with TV list filters.
Sampled 14 Oct 2026: 19 items, 2 fields filled in every item. name: “Action” and 18 other values.
MCP tool tmdb_genres
/tmdb/person/listReturns one page from TMDB's Popular People directory, including each person's id, name, known-for titles, profile image, and detail URL.
Sampled 14 Oct 2026: 20 items, 5 fields filled in every item. profile_url: media.themoviedb.org; uri: themoviedb.org.
MCP tool tmdb_person_list
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
How to scrape TMDB
TMDB's movie, TV, and people data power film and TV research. Crawlora's TMDB endpoints return search, title detail, person detail, and curated lists as normalized JSON — no TMDB API key, rate-limit juggling, or proxy setup. A pull on 2026-10-27 showed 19 movie genres and 16 TV genres, 10 results per page for the popular list and for search, and a release date returned as text.
/tmdb/search?query=Inception returned 20 results with a type field and has_next_page true on 2026-10-30. Use the id and type to pick /tmdb/movie/{id}, /tmdb/tv/{id} or /tmdb/person/{id}.
/tmdb/movie/27205 returned Inception (2010, 148 minutes), /tmdb/tv/1396 returned Breaking Bad with 62 episodes and status Ended, and /tmdb/person/31 returned Tom Hanks with a filmography of 8 items at limit 20.
/tmdb/genres returned 19 movie genres and 16 TV genres, /tmdb/collection/263 returned The Dark Knight Collection with 3 movies, and the popular lists return 20 rows per page.
/tmdb/movie/list and /tmdb/tv/list accept category, sort_by, with_genres, original_language, date_from, date_to, min_rating, max_rating, min_votes and runtime bounds, /tmdb/person/list pages people, and /tmdb/collection/{id} groups a franchise. /tmdb/search takes query with type, page and limit; a dune query with limit 5 on 2026-10-30 returned 5 results and has_next_page true.
genres returned 19 movie genres and 16 TV genres with different ids (the TV list starts with Action & Adventure, id 10759). Pass the right list's ids to the movie-list and tv-list routes.
The popular movie list returned 10 per page with has_next_page true; the first was Spider-Man: Brand New Day (id 969681). search for inception returned 10 results, the first being Inception (id 27205).
Search rows give release_date as text, for example July 15, 2010, not ISO-8601. Parse it before sorting.
Agent skills
Install a Crawlora agent skill and your agent can pull TMDB data as JSON through the documented API, without writing a scraper. These skills cover TMDB:
Researches movies and TV titles across IMDb, TMDB, JustWatch, Rotten Tomatoes, and Metacritic using the Crawlora API. Use for title discovery, cast…
npx skills add github.com/Crawlora-org/crawlora-skills --skill entertainment-discovery-researchResearches movies and TV shows — metadata, cast/crew, ratings, reviews, streaming availability, and box-office performance — via the Crawlora API…
npx skills add github.com/Crawlora-org/crawlora-skills --skill movie-tv-researchFAQ
Send a query or a TMDB id to Crawlora's TMDB endpoints and get movie, TV, and person data as structured JSON — search, detail, and curated lists — without writing parsers or holding a TMDB API key. Collect public data and respect TMDB's terms.
Yes — /tmdb/search returns mixed results across movies, TV shows, and people, or you can filter by type. Field availability varies by type: movie and TV hits carry release date and overview; person hits are title and link only.
Collecting publicly accessible movie, TV, and person data is generally permissible if you respect TMDB's terms of use, robots directives, rate limits, and applicable law. This is for public data you are authorized to collect.
Not in the 2026-10-27 pull: release_date for Inception was the text July 15, 2010.