IMDb Scraper

Scrape IMDb — the world's most popular entertainment database with 9M+ titles. Browse top-rated charts, search by title or cast, fetch full metadata by IMDb ID, or run advanced searches with genre/year/rating/votes filters. HTTP-only via the public IMDb GraphQL API. No auth, no cookies, no proxy required.

What this actor does

• Five modes: search, byId, topRated, popular, advanced
• Chart types: IMDb Top 250, Top 250 TV, Bottom 100, English-only charts, and Indian language charts (Bengali, Malayalam, Tamil, Telugu)
• Advanced filters: title type, genres, year range, minimum rating, minimum votes, custom sort
• Full metadata: cast, director, writers, genres, runtime, release date, rating, votes, plot
• Empty fields are omitted — records never contain null values

Output per title

• imdbId — IMDb title ID (e.g. tt0111161)
• title, titleType
• releaseYear, endYear (TV series)
• rating, voteCount
• runtimeMinutes
• genres[]
• plot
• imageUrl — poster image from IMDb
• director, writers[], cast[] (up to 15)
• countriesOfOrigin[], languages[]
• topRank — chart position (present in topRated mode)
• imdbUrl
• scrapedAt

Input

Field	Type	Default	Description
mode	string	topRated	search / byId / topRated / popular / advanced
searchQuery	string	–	Title search query (mode=search)
imdbIds	array	–	IMDb IDs to fetch (mode=byId)
topRatedChart	string	TOP_250	Chart type for topRated mode
titleType	string	–	Filter by type: movie, tvSeries, tvEpisode, short, videoGame, etc.
genres	array	–	Filter by genres (e.g. ["Drama", "Thriller"])
yearMin	int	–	Only include titles from this year onward
yearMax	int	–	Only include titles up to this year
minRating	float	–	Only include titles with rating ≥ this value (0–10)
minVotes	int	–	Only include titles with votes ≥ this value
sortBy	string	RANKING	Sort field for advanced mode
sortOrder	string	ASC	ASC or DESC
maxItems	int	50	Hard cap (1–500)

Example: Top 250 movies

{
  "mode": "topRated",
  "topRatedChart": "TOP_250",
  "maxItems": 50
}

Example: Search for a specific title

{
  "mode": "search",
  "searchQuery": "The Dark Knight",
  "maxItems": 10
}

Example: Fetch by IMDb IDs

{
  "mode": "byId",
  "imdbIds": ["tt0111161", "tt0468569", "tt1375666"]
}

Example: Advanced search — sci-fi movies after 2010 with high ratings

{
  "mode": "advanced",
  "titleType": "movie",
  "genres": ["Sci-Fi"],
  "yearMin": 2010,
  "minRating": 7.5,
  "minVotes": 50000,
  "sortBy": "USER_RATING",
  "sortOrder": "DESC",
  "maxItems": 100
}

Available chart types

Value	Description
TOP_250	IMDb Top 250 movies of all time
TOP_250_ENGLISH	Top 250 English-language movies
TOP_250_TV	IMDb Top 250 TV series
BOTTOM_100	IMDb Bottom 100 lowest-rated movies
TOP_50_BENGALI	Top 50 Bengali-language films
TOP_50_MALAYALAM	Top 50 Malayalam-language films
TOP_50_TAMIL	Top 50 Tamil-language films
TOP_50_TELUGU	Top 50 Telugu-language films
TOP_250_INDIA	Top 250 Indian films overall

Use cases

• Film recommendation engines — bulk-export Top 250 with full metadata for ML pipelines
• Content cataloging — fetch metadata for a known list of IMDb IDs
• Market research — track what genres, years, and directors dominate audience ratings
• Entertainment databases — keep your title catalog in sync with IMDb ratings and vote counts
• Data journalism — analyze trends in highly rated TV and films over decades
• Kids/family filtering — combine with genre filter to find top-rated family movies

FAQ

Does this require an IMDb account or API key? No. The actor uses IMDb's public GraphQL API which is accessible without authentication.

What is the topRatedChart default? TOP_250 — the classic IMDb Top 250 all-time movies list.

How often is IMDb data updated? IMDb updates ratings daily. Running the actor daily will keep your dataset fresh.

Can I get episode-level data for TV shows? The current actor returns series-level records. Individual episode data can be fetched using mode=byId with episode IMDb IDs.

Why are cast lists capped at 15? To keep records compact. Top-billed cast is the most search-relevant data; full cast is available on IMDb.

How do I find the IMDb ID of a title? Visit the title's IMDb page — the ID is in the URL: imdb.com/title/tt0111161/. Pass it without the tt prefix or with it — both formats work.

What title types are available? movie, tvSeries, tvMiniSeries, tvEpisode, tvSpecial, short, videoGame, video, musicVideo, podcastSeries, podcastEpisode.

What sort options are available for advanced mode? RANKING, USER_RATING, NUM_VOTES, YEAR, POPULARITY, RUNTIME, TITLE.

Is the actor free to run? Yes — it runs on Apify free plan with zero configuration and uses no paid proxy.