TMDB Scraper — Movies, TV Shows & People

The richest clean media API in one actor — movies, TV and people from The Movie Database (TMDB): search, full details (cast, crew, director, budget, revenue, genres, keywords, runtime, IMDb id), trending, and full Discover queries with filters. Multi-language, normalized schema, image URLs. Bring your own free TMDB v3 key.

Perfect for media apps, recommendation engines, catalogs, movie/TV datasets and enrichment pipelines.

What you get

• search-movie / search-tv / search-person / multi-search — search results with title, date, rating, popularity, genre ids, language and poster/backdrop URLs
• trending — trending movies/TV/people for a day or week window
• discover-movie — TMDB Discover with any filters (sort, rating, year, genre, min votes)
• movie-detail / tv-detail — full records: tagline, runtime, status, genres, budget, revenue, productionCompanies, imdbId, homepage, director, top-15 cast, keywords (TV adds numberOfSeasons, numberOfEpisodes, networks, creators, air dates)

Bring your own key (free)

TMDB requires a free v3 API key — get one at themoviedb.org/settings/api and set it in the apiKey input (stored as a secret). It is required: without a valid key the actor stops immediately with a clear error instead of returning bad data.

Input

Field	Type	Default	Description
mode	enum	search-movie	search-movie, search-tv, search-person, multi-search, trending, discover-movie, movie-detail, tv-detail
query	string	—	Search term (search modes)
ids	array	—	TMDB ids (detail modes)
mediaType	enum	all	For trending: all/movie/tv/person
timeWindow	enum	week	For trending: day/week
discoverFilters	object	—	For discover-movie: raw TMDB Discover params
includeCredits	boolean	true	Detail modes: also fetch cast, crew & keywords
language	string	en-US	ISO language tag, e.g. ro-RO, fr-FR
apiKey	string (secret)	—	Required — your free TMDB v3 key
maxResults	integer	100	Cap for search/trending/discover

Example input

{"mode":"movie-detail","ids":["27205","157336"],"includeCredits":true,"apiKey":"<YOUR_TMDB_KEY>"}

Search movies:

{"mode":"search-movie","query":"matrix","maxResults":50,"apiKey":"<YOUR_TMDB_KEY>"}

Discover top-rated 2023 films:

{"mode":"discover-movie","discoverFilters":{"sort_by":"vote_average.desc","vote_count.gte":5000,"primary_release_year":2023},"apiKey":"<YOUR_TMDB_KEY>"}

Output (movie-detail)

Fields below are the real normalizer output:

{
  "mediaType": "movie",
  "id": 27205,
  "title": "Inception",
  "originalTitle": "Inception",
  "tagline": "Your mind is the scene of the crime.",
  "releaseDate": "2010-07-15",
  "runtime": 148,
  "status": "Released",
  "overview": "Cobb, a skilled thief who commits corporate espionage...",
  "genres": ["Action", "Science Fiction", "Adventure"],
  "voteAverage": 8.4,
  "voteCount": 35000,
  "popularity": 82.5,
  "budget": 160000000,
  "revenue": 825532764,
  "language": "en",
  "productionCompanies": ["Legendary Pictures", "Syncopy"],
  "productionCountries": ["United States of America"],
  "imdbId": "tt1375666",
  "homepage": "https://www.warnerbros.com/movies/inception",
  "director": "Christopher Nolan",
  "cast": [{ "name": "Leonardo DiCaprio", "character": "Dom Cobb" }],
  "keywords": ["dream", "heist", "subconscious"],
  "poster": "https://image.tmdb.org/t/p/w500/edv5CZvWj09upOsy2Y6IwDhK8bt.jpg",
  "url": "https://www.themoviedb.org/movie/27205"
}

Search modes return a lighter shape (title, releaseDate, voteAverage, poster, …). Poster and backdrop paths are expanded to full image URLs.

Why this actor

• Breadth + depth — movies, TV and people; search, detail, trending and full Discover filters.
• BYO-key — you stay on your own TMDB agreement (clean commercial path); the actor never ships a key.
• Normalized schema with ready-to-use image URLs and IMDb cross-ids.

Pricing

Pay per result — $2.00 per 1,000 results (one result = one movie / show / person). No subscription or platform fees.

Related actors

• TVMaze Scraper — TV shows, full episode lists and cast (keyless).
• JustWatch Scraper — where to stream / rent / buy any title, per country.
• Google Books Scraper — books, ISBNs and prices.

Notes

• BYO-key: supply your own free TMDB v3 key (kept secret). If the key is missing/invalid the actor exits with an error rather than returning empty results.
• This product uses the TMDB API but is not endorsed or certified by TMDB.