TheMoviedb Scraper avatar

TheMoviedb Scraper

Pricing

Pay per usage

Go to Apify Store
TheMoviedb Scraper

TheMoviedb Scraper

Introducing TheMoviedb Scraper! This versatile actor extracts rich movie, TV, and celebrity data from TheMovieDB. It offers two modes: use the official API for fast, stable results, or scrape directly without a key. Your complete media data solution.

Pricing

Pay per usage

Rating

5.0

(3)

Developer

Shahid Irfan

Shahid Irfan

Maintained by Community

Actor stats

2

Bookmarked

35

Total users

5

Monthly active users

2 days ago

Last modified

Features

Limited permissions

Share

What does TMDb Comprehensive Scraper do?

TMDb Comprehensive Scraper collects movie, TV show, and people data from The Movie Database (TMDb) into one clean dataset. Search for titles by name, or let the actor discover titles with genre, year, rating, and vote filters. Each record contains the full title payload plus the optional groups you enable, such as cast and crew, reviews, images, keywords, videos, watch providers, and franchise collections.

The actor works without an API key. If you have your own TMDb API key, add it to run against the official TMDb API.

Why use TMDb Comprehensive Scraper?

  • One actor for three record types. Collect movies, TV shows, or people records, or collect movies and TV shows in the same run.
  • Search or discover. Run targeted name searches, or pull popular and top-rated titles with filters.
  • Choose the detail level. Basic metadata by default. Turn on cast, reviews, images, keywords, videos, watch providers, or collections only when you need them.
  • Clean, analysis-ready output. Empty values are removed, image paths become full URLs, and duplicate titles are skipped across queries.
  • No key required. Public TMDb data works out of the box, so you can test before creating an API key.
  • Batch output. Records are written to the dataset as each page finishes, so partial progress is kept if a later request fails.

What data can you extract?

GroupWhat you get
Title metadataTitle or name, original title, overview, tagline, status, runtime, release date or first air date, original language, popularity, vote average, vote count, budget, revenue
ClassificationsGenres, production companies, production countries, spoken languages, networks, origin countries, adult flag
Cast and crewFull credits for the title, including character names, departments, and job titles
ReviewsUser reviews with author, rating, excerpt, and timestamps, limited per title
ImagesPosters, backdrops, logos, and profile images as full image URLs
KeywordsTitle keywords and tags
VideosTrailers, teasers, clips, and featurettes with site, key, size, and type
Watch providersStreaming, rental, and purchase availability by country
CollectionsFull franchise record for movies that belong to a collection, including every part
Related titlesRecommendations and similar title lists
External IDsIMDb, Wikidata, Facebook, Instagram, Twitter, and other identifiers
PeopleBiography, birthday, deathday, place of birth, known-for department, profile image, combined credits, external IDs
Run contextContent type, search mode, query, TMDb ID, fetch timestamp, and any requested groups that came back empty

How to use TMDb Comprehensive Scraper

  1. Pick a content type: movies, TV shows, people, or both.
  2. Enter search queries, or leave the field empty to use discover mode with the filters.
  3. Set the maximum results and page limits.
  4. Enable the optional data groups you need.
  5. Start the run and open the dataset when it finishes.

If you enter search queries and filters at the same time, the search queries win and the discover filters are ignored for that run. Clear the search field to use the filters.

Find a movie by name

{
"contentType": "movie",
"searchQueries": "The Matrix, Inception",
"resultsWanted": 5,
"collectPeople": true
}

Discover top-rated titles with filters

{
"contentType": "tv",
"searchQueries": "",
"genreIds": "18,10765",
"yearFrom": 2015,
"yearTo": 2026,
"sortBy": "vote_average.desc",
"minVoteCount": 500,
"minVoteAverage": 7.5,
"resultsWanted": 50,
"maxPages": 5
}

Collect a person profile

{
"contentType": "person",
"searchQueries": "Brad Pitt",
"peopleResultsWanted": 2
}

Collect a movie with every detail group

{
"contentType": "movie",
"searchQueries": "The Matrix",
"resultsWanted": 1,
"collectPeople": true,
"collectReviews": true,
"collectImages": true,
"collectKeywords": true,
"collectVideos": true,
"collectWatchProviders": true,
"collectCollections": true,
"maxReviewsPerContent": 10,
"maxImagesPerContent": 15
}

Input parameters

FieldTypeDefaultDescription
apiKeystringemptyOptional TMDb API key. When set, the official TMDb API is used. Keep it secret.
useApiFirstbooleantrueWith an API key, try the official API first and fall back if it fails.
contentTypestringtvmovie, tv, person, or both.
searchQueriesstringemptyComma-separated search terms. Each term runs separately. Empty means discover mode.
genreIdsstringemptyComma-separated TMDb genre IDs for discover mode.
yearFromintegeremptyEarliest release year or first air year for discover mode.
yearTointegeremptyLatest release year or first air year for discover mode.
peopleQuerystringemptyComma-separated names to collect as people records, in addition to content.
resultsWantedinteger5Maximum content records per search query or discover run.
peopleResultsWantedinteger3Maximum people records per people query.
maxPagesinteger5Maximum result pages per query. Each page holds up to 20 items.
sortBystringpopularity.descDiscover sort order. Release date sorts apply to movies only, first air date sorts to TV shows only.
minVoteCountinteger0Minimum vote count for discover mode.
minVoteAveragenumber0Minimum average rating for discover mode.
collectPeoplebooleanfalseAdd cast and crew.
collectReviewsbooleanfalseAdd user reviews.
collectImagesbooleanfalseAdd posters, backdrops, logos, and profile images.
collectKeywordsbooleanfalseAdd keywords and tags.
collectVideosbooleanfalseAdd videos and trailer metadata.
collectWatchProvidersbooleanfalseAdd streaming availability by country.
collectCollectionsbooleanfalseAdd the full franchise record for movies in a collection.
maxReviewsPerContentinteger25Reviews kept per title when reviews are enabled.
maxImagesPerContentinteger20Images kept per image group when images are enabled.
proxyConfigurationobjectnoneApify Proxy or your own proxy URLs.

Output data

FieldDescription
data_typecontent or person
content_typemovie or tv
query_modesearch, discover, or search_person
search_queryThe query used for the record, absent in discover mode
tmdb_idTMDb ID for a movie or TV record
person_idTMDb ID for a person record
source, auth_modeWhich endpoint family handled the request
fetchedAtCollection timestamp
title, nameMovie title or TV show name
original_title, original_nameOriginal-language title
overviewShort description
release_date, first_air_dateRelease or first air date
vote_average, vote_count, popularityRating and popularity metrics
genres, production_companies, production_countriesClassification objects
runtime, number_of_seasons, number_of_episodesLength and episode counts
poster_path, backdrop_path, profile_pathFull image URLs
external_idsIMDb, Wikidata, and social identifiers
credits, reviews, keywords, images, videosOptional groups, present when enabled
watch/providersStreaming availability by country code
collection_detailsFranchise record with all parts, when enabled
recommendations, similarRelated title lists
combined_creditsPerson acting and crew credits
missing_data_fieldsRequested groups that returned no data for that record

Sample output

{
"data_type": "content",
"content_type": "movie",
"query_mode": "search",
"search_query": "The Matrix",
"tmdb_id": 603,
"fetchedAt": "2026-11-18T11:17:50.868Z",
"title": "The Matrix",
"release_date": "1999-03-31",
"vote_average": 8.263,
"vote_count": 29282,
"popularity": 37.7739,
"genres": [
{ "id": 28, "name": "Action" },
{ "id": 878, "name": "Science Fiction" }
],
"runtime": 136,
"status": "Released",
"poster_path": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"backdrop_path": "https://image.tmdb.org/t/p/original/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"external_ids": {
"imdb_id": "tt0133093",
"wikidata_id": "Q83495",
"facebook_id": "TheMatrixMovie"
},
"collection_details": {
"id": 2344,
"name": "The Matrix Collection",
"parts": 4
}
}

Tips for best results

  • Search needs exact names. Name search matches what the target returns. Common names return many people, while a full unique name may return one match even when you ask for more.
  • Filters only apply to discover mode. If searchQueries is set, discover filters are skipped. Clear the field to use genres, years, and ratings.
  • Match the sort to the type. Release date sorts apply to movies, first air date sorts apply to TV shows. A mismatched sort can return an error or empty pages.
  • Start small. A run of 5 results with one or two optional groups is the fastest way to confirm your input before a large collect.
  • Raise maxPages for depth. The actor stops early when resultsWanted is reached, so a higher page limit matters only for large targets.
  • Check missing_data_fields. It lists the groups you requested that the target has no data for, so an empty group is visible instead of silently absent.
  • Proxies are rarely needed. Add Apify Proxy only if you plan very large runs from one IP.

Integrations

  • Export the dataset to CSV, Excel, JSON, or XML from Apify Console.
  • Send results to Google Sheets, Airtable, or a database with Apify integrations.
  • Call the Actor from your own code with the Apify API and read the dataset items.
  • Schedule recurring runs to keep a local or cloud media catalog current.
  • Connect webhooks to start a review or enrichment workflow when a run finishes.

Frequently asked questions

Do I need a TMDb API key? No. The actor works without a key. An optional key switches requests to the official TMDb API for your own account quota.

Why did I get fewer results than I asked for? Search results depend on the target. A precise name can match one person or a handful of titles. Discover runs also stop when the target has no more pages or when your filters exclude everything else.

Why is an optional group empty for some titles? Not every title has reviews, trailers, or streaming offers. The missing_data_fields field names the groups that came back empty for that record.

Where do TV shows store their title and date? TV records use name and first_air_date. Movies use title and release_date. Both are present when available.

Can I collect movies and TV shows in one run? Yes. Set contentType to both. Both record sets land in the same dataset with content_type marking each one.

Are there rate limits? The actor sends a small number of concurrent requests and retries temporary failures. Very large runs may be slowed by the target, so keep maxPages and optional groups reasonable.

Can I run this on a schedule? Yes. Save an input as a task and schedule it daily, weekly, or monthly. Each run appends to its own dataset.

Is the data allowed for commercial use? TMDb data is community-contributed and subject to TMDb's terms. Review them before publishing or redistributing content.

Support

Open the actor page on Apify and use the Issues tab, or contact the author through the Apify profile. Include the run ID and input so the problem can be reproduced.

This actor collects publicly available data from The Movie Database. It is not affiliated with, endorsed by, or sponsored by TMDb. You are responsible for how you use the data and for following TMDb's terms of service, including attribution requirements. Do not use the data to redistribute copyrighted media.