IMDb Scraper

Pull movie and TV data from IMDb at scale — ratings with vote counts, full cast and crew, genres, runtime, content certificates, plots, country of origin, posters, and optional user reviews. Search by title, paste IMDb URLs, or browse the entire catalog with type, genre, year, and rating filters. Built for data analysts, media and entertainment researchers, and app and catalog builders who need clean, structured IMDb data without collecting it title by title.

Why This Scraper?

• Three ways in, one dataset — search by title name, paste IMDb title URLs or bare tt… IDs, or browse the full IMDb catalog with advanced filters. Mix all three in a single run.
• 9 title types, 22 genres — narrow a catalog browse to movies, TV series, TV movies, TV episodes, mini-series, TV specials, shorts, or video games, across genres from Action and Sci-Fi to Film-Noir, Documentary, and Western.
• Curated catalog browsing — combine a release-year range, a minimum IMDb rating (0–10), and a sort order (popularity, IMDb rating, vote count, newest release, or A–Z) to build exactly the list you want.
• Ratings with vote counts on every title — the IMDb aggregate rating and the total number of votes, so you can weight a 9.2 from 2 million voters differently from a 9.2 from 200.
• Full credits per title — directors, writers, and top-billed cast, plus content certificate (e.g. PG-13), runtime, country of origin, poster image, and plot synopsis.
• Up to 500 user reviews per title — opt in to pull each review with its rating, headline, author, date, helpfulness votes, and full text, returned as separate review records keyed back to the title.
• Batch input — feed many search terms or many URLs at once; each one runs to its own result cap.
• 10 interface languages — request titles and text in English, Spanish, French, German, Italian, Portuguese, Hindi, Japanese, Korean, or Chinese where IMDb provides them.

Use Cases

Market Research & Competitive Analysis

• Benchmark a studio's catalog by rating and vote count against rival releases
• Track how a genre's average rating shifts across release decades
• Size the back-catalog of a streaming acquisition target by title type

Media & Entertainment Analytics

• Build rating-vs-vote-count datasets to model audience reception
• Compare critical reception across countries of origin
• Surface the highest-rated titles in a genre for editorial round-ups

App & Catalog Building

• Seed a movie or TV recommendation app with structured title metadata
• Populate a watchlist product with posters, runtimes, and certificates
• Keep a media catalog fresh with ratings and new releases

Academic & Cultural Research

• Study representation trends by country of origin across a year range
• Analyze runtime or certificate distributions over time
• Mine user reviews for sentiment and reception studies

Content & SEO Teams

• Generate "best of the decade" lists backed by real ratings and vote counts
• Pull plot summaries and credits to enrich movie and TV articles
• Source quotable user reviews for engagement features

Getting Started

Simple Title Search

The simplest run — one title name, the default 50 results:

{
    "searchTerms": ["The Godfather"]
}

Specific Titles by URL or ID

Pull full details for an exact set of titles — paste IMDb URLs or bare tt… IDs:

{
    "startUrls": [
        "https://www.imdb.com/title/tt0068646/",
        "tt0468569"
    ]
}

Advanced Filtered Browse with Reviews

Build a curated list — top-rated drama and crime movies from the 1990s, sorted by IMDb rating, with the 10 most relevant reviews per title:

{
    "useAdvancedFilters": true,
    "titleType": "feature",
    "genres": ["drama", "crime"],
    "releaseYearMin": 1990,
    "releaseYearMax": 1999,
    "ratingMin": 8,
    "sortBy": "rating",
    "maxResults": 100,
    "maxReviewsPerTitle": 10
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchTerms	string[]	["The Godfather"]	Movie or TV show names to search for. Each term returns its matching titles. Leave empty if using URLs or advanced filters.
startUrls	string[]	[]	IMDb title URLs (e.g. https://www.imdb.com/title/tt0068646/) or bare IMDb IDs like tt0068646, for pulling full details on specific titles.

Advanced Filters

These apply only when useAdvancedFilters is on.

Parameter	Type	Default	Description
useAdvancedFilters	boolean	false	Browse IMDb's full title catalog with the filters below instead of, or in addition to, search terms.
titleType	string	"feature"	Restrict results to one kind of title: Movie, TV Series, TV Movie, TV Episode, TV Mini-Series, TV Special, Short, Video Game, or Any type.
genres	string[]	[]	Only include titles in these genres. Choose from 22 IMDb genres (Action, Comedy, Drama, Film-Noir, Sci-Fi, …). Empty means all genres.
releaseYearMin	integer	null	Only include titles released in or after this year.
releaseYearMax	integer	null	Only include titles released in or before this year.
ratingMin	integer	null	Only include titles with an IMDb rating at or above this value (0–10).
sortBy	string	"popularity"	Order results by Popularity, IMDb Rating, Number of Votes, Release Date (newest), or Title (A–Z).

Options

Parameter	Type	Default	Description
maxResults	integer	50	Maximum titles per search term or filter set. Set to 0 for as many as available.
maxReviewsPerTitle	integer	0	Also collect up to this many user reviews per title (capped at 500). 0 skips reviews. Keep it low (10–50) on popular titles to control cost.
language	string	"en"	Preferred language for IMDb titles and text where available. English, Spanish, French, German, Italian, Portuguese, Hindi, Japanese, Korean, or Chinese.

Output

Every row carries a recordType field — title or review — so you can filter cleanly downstream. Review rows are emitted only when maxReviewsPerTitle is greater than 0, and each one carries the parent title's imdbId as a foreign key.

Title (recordType: "title")

{
    "recordType": "title",
    "imdbId": "tt0068646",
    "title": "The Godfather",
    "originalTitle": "The Godfather",
    "titleType": "movie",
    "year": "1972",
    "rating": 9.2,
    "ratingCount": 2089456,
    "certificate": "R",
    "runtime": "2h 55min",
    "genres": ["Crime", "Drama"],
    "director": "Francis Ford Coppola",
    "writers": ["Mario Puzo", "Francis Ford Coppola"],
    "stars": ["Marlon Brando", "Al Pacino", "James Caan"],
    "country": "United States",
    "description": "The aging patriarch of an organized crime dynasty transfers control of his clandestine empire to his reluctant son.",
    "image": "https://m.media-amazon.com/images/M/MV5B...._V1_.jpg",
    "url": "https://www.imdb.com/title/tt0068646/"
}

Core fields

Field	Type	Description
recordType	string	Always "title"
imdbId	string	Canonical IMDb ID (tt…)
title	string	Display title
originalTitle	string	Original-language title, when it differs from the display title
titleType	string	IMDb's own type label — movie, tvSeries, tvMiniSeries, short, etc. (a feature filter returns movie)
year	string	Release year, or a range like "2008–2013" for a series
url	string	Canonical IMDb title URL

Ratings

Field	Type	Description
rating	number	IMDb aggregate rating, 0–10 (null if unrated)
ratingCount	number	Total number of votes behind the rating
certificate	string	Content certificate (e.g. PG-13, R, TV-MA); null when unrated

Credits & details

Field	Type	Description
runtime	string	Human-readable runtime, e.g. "2h 55min"
genres	string[]	List of genres
director	string	Director(s), comma-joined
writers	string[]	Credited writers
stars	string[]	Top-billed cast
country	string	Country or countries of origin
description	string	Plot synopsis
image	string	Poster image URL (null when IMDb has no poster)

Review (recordType: "review")

Emitted only when maxReviewsPerTitle is greater than 0. Capped at 500 per title.

{
    "recordType": "review",
    "imdbId": "tt0068646",
    "reviewTitle": "A masterpiece of American cinema",
    "reviewText": "From the opening wedding sequence to the final closing door, every frame is purposeful...",
    "reviewRating": 10,
    "author": "filmlover_1972",
    "date": "2019-03-14",
    "helpfulVotes": 487,
    "url": "https://www.imdb.com/review/rw1234567/"
}

Field	Type	Description
recordType	string	Always "review"
imdbId	string	Parent title's IMDb ID — join reviews back to their title
reviewTitle	string	Review headline
reviewText	string	Full review body
reviewRating	number	Reviewer's score, 1–10 (null if none given)
author	string	Reviewer's username
date	string	Review submission date
helpfulVotes	number	How many users found the review helpful
url	string	Permalink to the review on IMDb

Tips for Best Results

• Pick the input mode that fits the job. Search terms are best for known titles, URLs and IDs for an exact set, and advanced filters for discovering titles you don't yet know by name.
• Combine the year range and minimum rating to build a curated "best of decade" list. Set releaseYearMin/releaseYearMax to the decade, ratingMin to 8, and sortBy to rating for an instant ranked shortlist.
• Enable reviews only on the handful of titles you truly care about. Each review is returned as its own result, so a blockbuster with thousands of reviews can balloon a run — keep maxReviewsPerTitle at 10–50 unless you specifically need the full review set.
• Use sortBy: "votes" to find the most-discussed titles, not just the highest-rated — a niche film can score 9.0 from a few hundred voters, while vote count reveals mainstream reach.
• Set maxResults to 0 only with tight filters. An unfiltered catalog browse is enormous; pair 0 with a specific genre, year range, and title type to keep the run focused.
• Lean on titleType for clean datasets. Restricting to feature or tv_series keeps episodes and shorts out of a movie-level analysis.
• Set the language to localize titles when building a catalog for a specific regional audience.

Pricing

From $5.00 per 1,000 results — undercutting the typical market rate for IMDb extraction while bundling ratings, full credits, and optional reviews at no extra charge. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows the total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.60	$0.57	$0.54	$0.50
1,000	$6.00	$5.65	$5.35	$5.00
10,000	$60.00	$56.50	$53.50	$50.00
100,000	$600.00	$565.00	$535.00	$500.00

No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. A "result" is any row in the output dataset, so each user review you collect counts as a separate result: a run with reviews enabled returns more billable results than a titles-only run. Keep maxReviewsPerTitle modest if you want a predictable, titles-first cost.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate market research, media analytics, catalog building, and academic study. Users are responsible for complying with applicable laws and IMDb's terms of service, including making reasonable-rate requests and respecting content usage rules. Treat user reviews and any personal data with care, and do not use extracted data for spam, harassment, or any illegal purpose.