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

An unofficial IMDb scraper and structured IMDb data API in a single Apify Actor. Search movies and TV shows, pull full title details, ratings, user reviews, complete episode lists, and cast & crew — powered directly by IMDb's own public GraphQL endpoint. No API key, no login, no headless browser — just fast HTTP and clean, flat JSON you can export to CSV, Excel or JSON. Six modes share one input form, and every result is tagged with _mode so you can mix modes in a single dataset and filter later.

🏆 Why this IMDb scraper?

6 modes in 1 Actor (advanced search, free-text search, title details, episodes, reviews, people) · powered by IMDb's own GraphQL · hundreds of thousands of titles reachable via advanced search · ratings + votes on every title & episode · export to JSON / CSV / Excel. The unofficial IMDb API alternative for film & TV analytics, recommendation engines, ML datasets and AI agents — with no API key and no browser.

---

✨ 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	integer	searchTitles	IMDb average rating bounds (0–10).
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 — bulk-ingest titles, genres, ratings and cast to train content-based or collaborative recommenders.
• 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 — you pay for the items you extract, with no separate Apify platform fees to calculate. Try it on the free tier first, then scale up. See the Pricing tab on this page for the current rate.

❓ Frequently Asked Questions

Do I need an IMDb API key or account? No. This is an unofficial IMDb scraper that reads publicly available data through IMDb's own GraphQL endpoint. You only need an Apify account — no IMDb API key, no OAuth, no login.

Is this an IMDb API or an IMDb API alternative? Both, effectively. It works as an unofficial IMDb API and a practical IMDb dataset API alternative: send structured input, get structured JSON back, without the restricted official IMDb datasets or paid data licenses.

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, set the titleId, and the Actor paginates the public review feed — reviewer, star rating, full text, date and helpfulness votes — no key or login required.

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 collects only publicly available data served by IMDb's own endpoints. You are responsible for using the data in compliance with IMDb's terms 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 extracts only publicly available data served by IMDb's own endpoints and is intended for legitimate research, analytics and dataset-building use. You are responsible for complying with IMDb's terms of service and any applicable local laws.

---

📝 Changelog

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 public GraphQL — no key, no browser.