IMDb Scraper — Movies, TV, Ratings, Reviews & Cast Data API (No API Key)

An unofficial IMDb scraper with structured output in a single Apify Actor. Search movies and TV shows, pull title details, ratings, user reviews, episode lists, and cast & crew through IMDb's web GraphQL endpoint. No API key, login, or headless browser is required. Six modes share one input form, and every result is tagged with _mode so you can filter mixed datasets later.

🏆 Why this IMDb scraper?

6 modes in 1 Actor (advanced search, free-text search, title details, episodes, reviews, people) · powered by IMDb's web GraphQL · ratings + votes on titles and episodes · export to JSON / CSV / Excel — with no API key and no browser.

Usage restriction: IMDb's GraphQL responses carry a licensing disclaimer that restricts public, commercial, and other non-private use. Use this Actor only where your use is permitted by IMDb's current terms and licensing rules; obtain an IMDb data license when required.

---

✨ What this Actor does / Key features

• 🔍 Advanced title search — filter tens of thousands of movies and TV shows by title type, genre, release-date range, IMDb rating and vote count; sort by popularity, rating, release date, runtime, box office or Metascore; paginates the full result set.
• ⭐ Ratings everywhere — aggregateRating and voteCount on every title and episode, straight from IMDb.
• 🎬 Rich title details — title, originalTitle, titleType, year, endYear, runtimeMinutes, genres[], plot, poster imageUrl, popularity rank and top topCredits[] (director, writers, cast).
• 📺 Full episode lists — every episode of a series with seasonNumber, episodeNumber, releaseDate, per-episode rating and plot.
• 💬 User reviews — reviewer, star rating, summary, full review text, submission date and helpfulness up/down votes.
• 👤 People (cast & crew) — name, professions, biography, birth/death dates, photo and a knownFor[] filmography.
• 🧩 Batch lookups — feed many tt… or nm… IDs at once for titleDetails and name modes.
• 🗂️ 5 pre-built dataset views — Overview, Titles, Episodes, Reviews, People — slice the data with zero post-processing.
• ⚡ Direct GraphQL — no browser, no API key, no OAuth; every item carries _mode and scrapedAt (ISO 8601).

The 6 modes

Mode	What it returns
searchTitles	Advanced movie/TV search — filter by type, genre, year, rating, votes (highest volume)
search	Free-text search across titles, people and companies
titleDetails	Full details for one or many title IDs (batch)
episodes	Every episode of a TV series, paginated
reviews	User reviews for a title, paginated
name	Person / cast / crew details for one or many name IDs (batch)

🚀 Quick start (3 steps)

1. Pick a Mode — start with searchTitles to build a filtered movie/TV dataset, or use titleDetails / reviews / episodes / name with an IMDb ID.
2. Fill the fields that mode needs — the input form shows which apply (search filters, or a titleId like tt0111161 / nameId like nm0000138).
3. Run & export — download results as JSON, CSV, Excel, HTML, RSS or JSON Lines, or pull them via the Apify API.

📥 Input

Pick a mode, then fill only the fields that mode needs.

Example — advanced search for popular movies since 2020

{
  "mode": "searchTitles",
  "titleTypes": ["movie"],
  "releaseDateStart": "2020-01-01",
  "minVotes": 5000,
  "sortBy": "POPULARITY",
  "maxResults": 200
}

Example — pull user reviews for a title

{
  "mode": "reviews",
  "titleId": "tt0111161",
  "maxResults": 500
}

Example — batch title details for several movies

{
  "mode": "titleDetails",
  "titleIds": ["tt0111161", "tt0068646", "tt0468569"]
}

Field	Type	Used by	Description
mode	string	all	searchTitles, search, titleDetails, episodes, reviews or name. Required.
query	string	search	Free-text term (movie, show, actor, director or company).
searchType	string	search	Restrict to TITLE, NAME, COMPANY or KEYWORD.
titleTypes	array	searchTitles	movie, tvSeries, tvMiniSeries, tvMovie, short, videoGame… (defaults to movie).
genres	array	searchTitles	One or more genres (all must match): Action, Comedy, Drama, Sci-Fi…
releaseDateStart / releaseDateEnd	string	searchTitles	Release-date window (YYYY-MM-DD).
minRating / maxRating	number	searchTitles	IMDb average rating bounds (0–10), including decimals such as 7.5.
minVotes	integer	searchTitles	Minimum vote count (filters out obscure entries).
sortBy	string	searchTitles	POPULARITY, USER_RATING, USER_RATING_COUNT, RELEASE_DATE, RUNTIME, BOX_OFFICE_GROSS_DOMESTIC, METACRITIC_SCORE.
sortOrder	string	searchTitles	ASC or DESC.
titleId / titleIds	string / array	titleDetails, episodes, reviews	IMDb title ID(s) like tt0111161 (titleDetails accepts a batch).
nameId / nameIds	string / array	name	IMDb person ID(s) like nm0000138 (batch supported).
maxResults	integer	all	Row cap; drives pagination for search/episodes/reviews.
country / language	string	all	Localization: US / en-US, DE / de-DE, TR / tr-TR…

📤 Output

Results stream to the dataset; every item carries _mode and scrapedAt. Here is a trimmed title sample (from searchTitles / titleDetails):

{
  "_mode": "searchTitles",
  "id": "tt0111161",
  "title": "The Shawshank Redemption",
  "titleType": "Movie",
  "year": 1994,
  "aggregateRating": 9.3,
  "voteCount": 2894512,
  "runtimeMinutes": 142,
  "genres": ["Drama"],
  "plot": "Over the course of several years, two convicts form a friendship…",
  "imageUrl": "https://m.media-amazon.com/images/…/poster.jpg",
  "imdbUrl": "https://www.imdb.com/title/tt0111161/",
  "scrapedAt": "2026-07-06T12:00:00.000Z"
}

And a trimmed review sample (from reviews mode):

{
  "_mode": "reviews",
  "titleName": "The Shawshank Redemption",
  "author": "alexdrama",
  "authorRating": 10,
  "summary": "A near-perfect film",
  "text": "Few films earn their reputation the way this one does…",
  "submissionDate": "2026-05-18",
  "upVotes": 142,
  "downVotes": 6,
  "scrapedAt": "2026-07-06T12:00:00.000Z"
}

💡 Use cases

• Film & TV analytics — build a movie ratings dataset filtered by genre, decade and popularity, then chart trends in a BI tool.
• Recommendation engines & ML (licensed use only) — ingest titles, genres, ratings and cast when your IMDb license permits that processing.
• Review mining & sentiment — pull IMDb user reviews for a film or series and feed sentiment models or LLM summarizers.
• Catalog enrichment — enrich your own media catalog with IMDb metadata, posters, runtimes and cast lists via titleDetails.
• Market & competitor research — track top-rated or most-popular releases per year, monitor a studio's back catalog, or benchmark a show's episode ratings.
• AI agents & RAG — wrap the Actor as a tool so an LLM can answer "what are the top-rated sci-fi movies since 2020?" or embed plots and reviews.

👥 Who uses it

Film & TV data analysts · recommendation-engine and ML engineers · streaming & catalog teams enriching metadata · journalists and researchers · sentiment/NLP practitioners mining reviews · AI-agent builders wiring IMDb as a tool.

💰 Pricing

This Actor runs on a simple pay-per-result model. Actor pricing covers the extraction service only and does not grant an IMDb data license or expand your data-use rights. See the Pricing tab for the current Actor rate.

❓ Frequently Asked Questions

Do I need an IMDb API key or account? No IMDb credential is required for the web request, but this does not grant reuse rights. This unofficial Actor reads IMDb's web GraphQL endpoint; IMDb's response disclaimer and licensing rules still apply.

Is this an IMDb API or an IMDb API alternative? It provides a structured automation interface, but it is not an official IMDb API or a substitute for required licensing. IMDb's response disclaimer and current terms still govern how the returned data may be used.

How do I scrape IMDb ratings and vote counts? Every title and episode row includes aggregateRating (the IMDb average) and voteCount. Use searchTitles to build a filtered ratings dataset, or titleDetails for specific movies.

How do I get IMDb IDs (tt and nm)? A title ID looks like tt0111161 (the digits after tt in an IMDb title URL); a person ID looks like nm0000138. Use search or searchTitles first to discover IDs, then feed them into titleDetails, episodes, reviews or name.

Can I scrape IMDb reviews without an API key? Yes. Pick reviews mode and set the titleId; the Actor paginates IMDb's web review feed. Use the returned data only where IMDb's current terms and your license permit it.

Does it cover TV series and episodes? Yes. Use searchTitles with titleTypes: ["tvSeries"] to find shows, then episodes mode with the series titleId to pull every episode with season/episode numbers and per-episode ratings.

How much data can advanced search return? Advanced title search runs against IMDb's full catalog — a single filter set can match hundreds of thousands of titles. The Actor paginates up to your maxResults, so you can pull large movie and TV datasets in one run.

Is the data localized by country? You can set country and language (e.g. US / en-US, DE / de-DE) to influence IMDb localization of titles and text.

How do I export IMDb data to CSV, JSON or Excel? Run any mode and download the dataset as CSV, JSON, Excel (XLSX), HTML, RSS or JSON Lines from the run page, or pull it via the Apify API. This makes it a simple IMDb data export and movie-dataset tool.

Is it legal to scrape IMDb? The Actor reads data served by IMDb's web endpoint. IMDb's response disclaimer restricts public, commercial, and other non-private use; you are responsible for complying with IMDb's current terms, licensing requirements, and applicable laws.

🔗 More media & social scrapers by logiover

Building a media, entertainment or social dataset? Pair IMDb with the rest of the suite:

Actor	What it does
TVmaze Scraper	TV show schedules, episodes and cast from TVmaze
MyAnimeList Scraper	Anime & manga titles, scores and metadata
Letterboxd Film Review Scraper	Film reviews, ratings and lists from Letterboxd
Steam Game Reviews Scraper	Player reviews and ratings from Steam
Discogs Scraper	Music releases, artists and labels from Discogs
Apple Podcasts Episode Scraper	Podcast episodes and show metadata
YouTube Video Details Scraper	Video stats, metadata and channel info
YouTube Comments Scraper	Comment threads and engagement from YouTube
Twitch Scraper	Streams, channels and metadata from Twitch
Reddit Subreddit Scraper	Posts, scores and comments from any subreddit
Resident Advisor Scraper	Music events, clubs and lineups
Wikipedia Category Scraper	Walk Wikipedia categories and export page metadata

👉 Browse all logiover scrapers on Apify Store — 180+ actors across real estate, jobs, crypto, social media & B2B data.

⏰ Scheduling & integration

Schedule this Actor on Apify to refresh a movie/TV dataset daily or weekly. Export results to JSON, CSV or Excel, sync to Google Sheets, or push to your database, BI tools and webhooks through the Apify API. Call it from your stack via run-sync-get-dataset-items, the JavaScript/Python clients, or no-code tools like Make, n8n and Zapier.

⭐ Support & feedback

Found a bug or need an extra field or mode? Open an issue on the Issues tab — response is usually fast. If this Actor saves you time, a ★★★★★ review on the Store page genuinely helps and is hugely appreciated. 🙏

⚖️ Legal

This Actor reads data served by IMDb's web endpoint. It does not grant data-use rights: IMDb's response disclaimer restricts public, commercial, and other non-private use. You are responsible for obtaining any required license and complying with IMDb's terms and applicable law.

---

📝 Changelog

2026-08-01

• Completed the August 2026 full health check: verified empty/programmatic default, Console UI default, and two source-informed alternative inputs on Apify.
• Confirmed successful live execution, non-empty structured output, dataset-field/type integrity, and logical sample quality within the 5-minute quality window.
• Declared 15 dataset fields from typed live cloud samples so the output contract is no longer an empty placeholder.
• Declared 19 nullable dataset fields from typed live cloud samples so the output contract is no longer an empty placeholder or brittle to sparse modes.

2026-08-01 — Health-check remediation

• August 2026 monthly health-check remediation is in progress; this build contains fixes verified from empty/default, Console-default, targeted live probes, or field-level semantic review.
• Restored GraphQL access with the required IMDb referer, made zero-result transport/parser failures fail explicitly, added keyword mapping and corrected rating types and data-licensing guidance.
• The final four-input matrix verdict will be appended after post-build cloud revalidation.

2026-07-06

• ✨ README overhaul: added shields badges, a richer per-mode output sample and field reference, ready-to-run example scenarios, a media/social cross-promo grid, and a clearer quick-start.

2026-07-01

• Initial release: six IMDb modes (advanced title search, free-text search, title details, episodes, reviews, people) over IMDb's web GraphQL endpoint — no key, no browser.