TheMoviedb Scraper
Pricing
Pay per usage
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
Maintained by CommunityActor stats
2
Bookmarked
35
Total users
5
Monthly active users
2 days ago
Last modified
Categories
Features
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?
| Group | What you get |
|---|---|
| Title metadata | Title or name, original title, overview, tagline, status, runtime, release date or first air date, original language, popularity, vote average, vote count, budget, revenue |
| Classifications | Genres, production companies, production countries, spoken languages, networks, origin countries, adult flag |
| Cast and crew | Full credits for the title, including character names, departments, and job titles |
| Reviews | User reviews with author, rating, excerpt, and timestamps, limited per title |
| Images | Posters, backdrops, logos, and profile images as full image URLs |
| Keywords | Title keywords and tags |
| Videos | Trailers, teasers, clips, and featurettes with site, key, size, and type |
| Watch providers | Streaming, rental, and purchase availability by country |
| Collections | Full franchise record for movies that belong to a collection, including every part |
| Related titles | Recommendations and similar title lists |
| External IDs | IMDb, Wikidata, Facebook, Instagram, Twitter, and other identifiers |
| People | Biography, birthday, deathday, place of birth, known-for department, profile image, combined credits, external IDs |
| Run context | Content type, search mode, query, TMDb ID, fetch timestamp, and any requested groups that came back empty |
How to use TMDb Comprehensive Scraper
- Pick a content type: movies, TV shows, people, or both.
- Enter search queries, or leave the field empty to use discover mode with the filters.
- Set the maximum results and page limits.
- Enable the optional data groups you need.
- 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
| Field | Type | Default | Description |
|---|---|---|---|
apiKey | string | empty | Optional TMDb API key. When set, the official TMDb API is used. Keep it secret. |
useApiFirst | boolean | true | With an API key, try the official API first and fall back if it fails. |
contentType | string | tv | movie, tv, person, or both. |
searchQueries | string | empty | Comma-separated search terms. Each term runs separately. Empty means discover mode. |
genreIds | string | empty | Comma-separated TMDb genre IDs for discover mode. |
yearFrom | integer | empty | Earliest release year or first air year for discover mode. |
yearTo | integer | empty | Latest release year or first air year for discover mode. |
peopleQuery | string | empty | Comma-separated names to collect as people records, in addition to content. |
resultsWanted | integer | 5 | Maximum content records per search query or discover run. |
peopleResultsWanted | integer | 3 | Maximum people records per people query. |
maxPages | integer | 5 | Maximum result pages per query. Each page holds up to 20 items. |
sortBy | string | popularity.desc | Discover sort order. Release date sorts apply to movies only, first air date sorts to TV shows only. |
minVoteCount | integer | 0 | Minimum vote count for discover mode. |
minVoteAverage | number | 0 | Minimum average rating for discover mode. |
collectPeople | boolean | false | Add cast and crew. |
collectReviews | boolean | false | Add user reviews. |
collectImages | boolean | false | Add posters, backdrops, logos, and profile images. |
collectKeywords | boolean | false | Add keywords and tags. |
collectVideos | boolean | false | Add videos and trailer metadata. |
collectWatchProviders | boolean | false | Add streaming availability by country. |
collectCollections | boolean | false | Add the full franchise record for movies in a collection. |
maxReviewsPerContent | integer | 25 | Reviews kept per title when reviews are enabled. |
maxImagesPerContent | integer | 20 | Images kept per image group when images are enabled. |
proxyConfiguration | object | none | Apify Proxy or your own proxy URLs. |
Output data
| Field | Description |
|---|---|
data_type | content or person |
content_type | movie or tv |
query_mode | search, discover, or search_person |
search_query | The query used for the record, absent in discover mode |
tmdb_id | TMDb ID for a movie or TV record |
person_id | TMDb ID for a person record |
source, auth_mode | Which endpoint family handled the request |
fetchedAt | Collection timestamp |
title, name | Movie title or TV show name |
original_title, original_name | Original-language title |
overview | Short description |
release_date, first_air_date | Release or first air date |
vote_average, vote_count, popularity | Rating and popularity metrics |
genres, production_companies, production_countries | Classification objects |
runtime, number_of_seasons, number_of_episodes | Length and episode counts |
poster_path, backdrop_path, profile_path | Full image URLs |
external_ids | IMDb, Wikidata, and social identifiers |
credits, reviews, keywords, images, videos | Optional groups, present when enabled |
watch/providers | Streaming availability by country code |
collection_details | Franchise record with all parts, when enabled |
recommendations, similar | Related title lists |
combined_credits | Person acting and crew credits |
missing_data_fields | Requested 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
searchQueriesis 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
maxPagesfor depth. The actor stops early whenresultsWantedis 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.
Related Actors
- YouTube Search Scraper API for trailers, reviews, and video search results.
- Pixabay Image Scraper for extra artwork and visual assets.
- Discogs.com Scraper for music releases and catalog data.
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.
Legal notice
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.