# IMDb Scraper: Movies, TV, Ratings, Cast and Reviews (`themineworks/imdb-scraper`) Actor

Scrape IMDb by chart (Top 250, Most Popular, Box Office), keyword, filters, list or link: one row per title with rating, votes, genres, runtime, cast, directors, plot, release date, box office, Metascore and awards, plus people and optional user reviews. No login.

- **URL**: https://apify.com/themineworks/imdb-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Videos, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $14.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## IMDb Scraper: Movies, TV, Ratings, Cast and Reviews

[![50 IMDb Top 250 movies with rating, votes, cast, box office and Metascore in 3 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/imdb-scraper-hero.png)](https://console.apify.com/actors/5mpPKweghERqt9CWa/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns IMDb movies, TV shows and people from the IMDb charts (Top 250, Most Popular, Box Office and more), keyword search, filter search, public lists or links: one flat row per title with rating, votes, genres, runtime, release date, cast with characters, directors, writers, plot, certificate, Metascore, budget, box office, awards, seasons and episodes, plus person rows and optional user reviews. No login, no cookies, no API key. You pay $18.00 per 1,000 titles or people on the Free plan and $14.00 per 1,000 on the Gold plan, reviews $4.49 and $2.69 per 1,000, plus a $0.003 start fee per run.

From **The Mine Works**, with over 360,000 runs across 350+ public actors.

Updated 17 Nov 2026: first release. Eleven IMDb charts, title and people search, IMDb advanced search filters (type, genre, years, rating, votes, country, language, sort), public lists, title, name, find and search links, and user reviews with sort and spoiler filter. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The whole title in one row.** `rating`, `votes`, `metascore`, `popularity_rank`, `genres`, `runtime_minutes`, `release_date`, `certificate`, `plot`, `directors`, `writers`, `stars`, `cast` with character names, `countries`, `languages`, `keywords`, `production_companies`, `budget`, `gross_worldwide`, `gross_us_canada`, opening weekend, `award_wins`, `award_nominations` and the top award (Oscar, Emmy) with its wins. Series add `seasons` and `episodes`, episodes add the series and season and episode numbers.
- **Charts in rank order.** Top 250 Movies, Top 250 TV Shows, Most Popular Movies and TV Shows, the US Box Office weekend with the weekend gross, Lowest Rated, Top English, Indian, Tamil, Telugu and Malayalam movies. Every row carries its `rank`.
- **IMDb's own filters.** Title type, genres, release years, minimum rating, minimum votes, country of origin, language and sort order, with or without a keyword: the same search as IMDb's advanced title search, and pasted `/search/title/` links are read with their filters.
- **People and reviews too.** Search for people or paste name links for birth date and place, professions, biography, known for titles and award counts. Turn on reviews for the rating, headline, full text, date, helpful votes, spoiler flag and reviewer display name of each review.
- **Fast and light.** No browser and no proxy bill: the actor reads the same data the IMDb website loads, over plain HTTP. In our test runs on Apify every request went out directly: 50 Top 250 movies in 3 seconds, 968 titles and people in 36 seconds, 80 titles with 578 reviews in 24 seconds.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/5mpPKweghERqt9CWa/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works More tools family:** [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 50 movies of the IMDb Top 250 with every field. It took 3 seconds in our test run on Apify:

```json
{
  "charts": ["top-250-movies"],
  "maxItems": 50
}
```

Pick several charts at once, add keywords, set filters or paste IMDb links in the same run. A title that two of your sources find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 270 titles at this actor's price.

#### Copy to your AI assistant

```text
themineworks/imdb-scraper on Apify. Reads IMDb by chart, keyword, filters, list or link and returns one flat row per title (movie, TV series, episode, game) or per person, and optionally one row per user review, with no login. Call ApifyClient("TOKEN").actor("themineworks/imdb-scraper").call(run_input={"charts": ["top-250-movies"], "maxItems": 250}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs (any mix): charts (list of top-250-movies, most-popular-movies, top-250-tv, most-popular-tv, box-office, lowest-rated-movies, top-english-movies, top-indian-movies, top-tamil-movies, top-telugu-movies, top-malayalam-movies), searchTerms (list of keywords) with searchType (titles or people, default titles), startUrls (IMDb title, reviews, name, list, chart, find or /search/title/ links, or ids like tt0111161, nm0634240, ls055592025). maxItems (default 50, 1 to 10,000, per source). Title filters (switch keyword search to IMDb advanced search; with no keyword they return every match): titleTypes (movie, tvSeries, tvMiniSeries, tvMovie, tvSpecial, tvEpisode, short, tvShort, video, videoGame, musicVideo, podcastSeries), genres (all must match, e.g. Horror, Sci-Fi), releaseYearFrom, releaseYearTo, minRating, minVotes, countries (2 letter codes), languages (2 letter codes), sortBy (popularity, rating, votes, newest, oldest, box_office, metascore, runtime, title). castLimit (default 15). includeReviews (default false) with maxReviewsPerTitle (default 20, up to 5,000), reviewsSort (helpful, newest, oldest, highest_rating, lowest_rating, most_votes) and excludeSpoilers. Rows have record_type title, person or review. Title rows: imdb_id, url, title, original_title, title_type, title_type_id, is_series, year, end_year, release_date, release_country, runtime_minutes, rating, votes, metascore, metacritic_reviews, popularity_rank, certificate, genres, plot, poster_url, countries, languages, keywords, directors, writers, stars, cast (name, imdb_id, character), cast_total, production_companies, budget, budget_currency, gross_worldwide, gross_us_canada, opening_weekend_us_canada, opening_weekend_date, gross_currency, weekend_gross, weekend_start, weekend_end (box office chart), user_reviews_count, seasons, episodes, series_imdb_id, series_title, season_number, episode_number, award_wins, award_nominations, top_award, top_award_wins, top_award_nominations, is_adult, rank, source, search_term, scraped_at. Person rows: imdb_id, url, name, professions, birth_date, birth_place, death_date, death_place, height, bio, photo_url, known_for (imdb_id, title, year), popularity_rank, credits_total, award_wins, award_nominations, top_award. Review rows: review_id, url, imdb_id, title, review_rating, review_title, review_text, review_date, helpful_votes, unhelpful_votes, is_spoiler, reviewer_name, review_language, position. Each run also writes one row with _type "summary", one with _type "info" when rows were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~imdb-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Eleven charts.** Top 250 Movies, Most Popular Movies (MOVIEmeter), Top 250 TV Shows, Most Popular TV Shows (TVmeter), Box Office (the latest US weekend, with `weekend_gross`), Lowest Rated Movies, Top Rated English, Indian, Tamil, Telugu and Malayalam Movies. Chart links such as `/chart/top/` work too.
- **Keyword search for titles or people.** Type a keyword the way you would in the IMDb search box. Results come in IMDb's own relevance order, up to 10,000 per keyword.
- **Filter search.** Title types, genres, release years, minimum rating, minimum votes, countries, languages and nine sort orders. Use them with keywords or alone, for example every South Korean TV series with 20,000 votes or more, best rated first.
- **Lists and links.** Public IMDb lists (`/list/ls...`, titles or people), title and name links or bare ids, reviews links, `/find/?q=` links and `/search/title/?...` links with their filters.
- **User reviews, optional.** `includeReviews` adds review rows for each title: most helpful, newest, oldest, highest or lowest rating, or most votes first, with or without spoilers.
- **Stops cleanly.** A source that returns nothing ends after one request. Six failed requests in a row end the run; the run stops before its time limit and keeps every row. The summary row says what happened to each source.

### How to use it

#### Basic: the whole Top 250

```json
{
  "charts": ["top-250-movies"],
  "maxItems": 250
}
```

One request lists the chart, then the titles are read 25 at a time. Each row has `rank` 1 to 250.

#### Market research: what is popular this week

```json
{
  "charts": ["most-popular-movies", "most-popular-tv", "box-office"],
  "maxItems": 100,
  "castLimit": 5
}
```

The Box Office rows carry `weekend_gross`, `weekend_start` and `weekend_end` next to the lifetime `gross_us_canada` and `gross_worldwide`.

#### A catalog by filters, no keyword

```json
{
  "titleTypes": ["movie"],
  "genres": ["Horror"],
  "releaseYearFrom": 2015,
  "minVotes": 50000,
  "sortBy": "rating",
  "maxItems": 500
}
```

This returned 259 horror films since 2015 with 50,000 votes or more in our test, best rated first.

#### Keyword search with reviews

```json
{
  "searchTerms": ["batman", "the office"],
  "maxItems": 40,
  "includeReviews": true,
  "maxReviewsPerTitle": 10,
  "reviewsSort": "helpful"
}
```

You get the title rows and, after each title, up to 10 review rows with `record_type` "review".

#### People

```json
{
  "searchTerms": ["christopher nolan", "zendaya"],
  "searchType": "people",
  "maxItems": 5
}
```

Or paste name links such as `https://www.imdb.com/name/nm0634240/` into `startUrls`.

### Input parameters

| Field | Type | Description |
|---|---|---|
| `charts` | list | IMDb charts to export, in rank order. |
| `searchTerms` | list | Keywords, one search each. |
| `searchType` | text | `titles` (default) or `people`. |
| `startUrls` | list | IMDb title, reviews, name, list, chart, find or `/search/title/` links, or ids such as `tt0111161`. |
| `maxItems` | number | Most rows per chart, keyword, filter search or list link (default 50, up to 10,000). |
| `titleTypes`, `genres` | list | Title types (any) and genres (all must match). |
| `releaseYearFrom`, `releaseYearTo` | number | Release year range. |
| `minRating`, `minVotes` | number | Lowest IMDb rating and number of votes. |
| `countries`, `languages` | list | Two letter codes, for example `US`, `IN` and `en`, `hi`. |
| `sortBy` | text | Order of filter results: popularity, rating, votes, newest, oldest, box_office, metascore, runtime, title. |
| `castLimit` | number | Cast members kept per title (default 15, up to 100). |
| `includeReviews` | true or false | Add review rows for each title (default off). |
| `maxReviewsPerTitle` | number | Reviews per title (default 20, up to 5,000). |
| `reviewsSort` | text | helpful, newest, oldest, highest_rating, lowest_rating, most_votes. |
| `excludeSpoilers` | true or false | Leave out reviews marked as spoilers. |

### What data do you get?

Every row has `record_type`: `title`, `person` or `review`. Use the Titles, People and Reviews views in the run's Storage tab, or filter on `record_type`.

**Title rows** (movies, series, episodes, shorts, games):

| Field | Example |
|---|---|
| `imdb_id`, `url` | tt0111161, https://www.imdb.com/title/tt0111161/ |
| `title`, `original_title` | The Shawshank Redemption |
| `title_type`, `title_type_id`, `is_series` | Movie, movie, false |
| `year`, `end_year`, `release_date`, `release_country` | 1994, 1994-10-14, United States |
| `runtime_minutes`, `certificate` | 142, R |
| `rating`, `votes`, `metascore`, `metacritic_reviews`, `popularity_rank` | 9.3, 3265844, 82, 22, 51 |
| `genres`, `keywords`, `plot` | \["Drama"], \["prison", ...], After a banker is sentenced to life... |
| `directors`, `writers`, `stars` | \["Frank Darabont"], \["Stephen King", "Frank Darabont"], \["Tim Robbins", ...] |
| `cast`, `cast_total` | \[{"name": "Tim Robbins", "imdb_id": "nm0000209", "character": "Andy Dufresne"}, ...], 74 |
| `countries`, `languages`, `production_companies` | \["United States"], \["English"], \["Castle Rock Entertainment"] |
| `budget`, `gross_worldwide`, `gross_us_canada`, `opening_weekend_us_canada`, `opening_weekend_date`, `gross_currency` | 25000000, 29442974, 28767189, 727327, 1994-09-25, USD |
| `user_reviews_count`, `award_wins`, `award_nominations`, `top_award`, `top_award_wins`, `top_award_nominations` | 12084, 21, 64, Oscar, 0, 7 |
| `seasons`, `episodes` | series only |
| `series_imdb_id`, `series_title`, `season_number`, `episode_number` | episodes only |
| `weekend_gross`, `weekend_start`, `weekend_end` | Box Office chart only |
| `poster_url`, `rank`, `source`, `search_term`, `scraped_at` | |

**Person rows**: `imdb_id`, `url`, `name`, `professions`, `birth_date`, `birth_place`, `death_date`, `death_place`, `height`, `bio`, `photo_url`, `known_for` (imdb_id, title, year), `popularity_rank`, `credits_total`, `award_wins`, `award_nominations`, `top_award`, `top_award_wins`, `top_award_nominations`.

**Review rows**: `review_id`, `url`, `imdb_id` and `title` of the reviewed title, `review_rating` (1 to 10), `review_title`, `review_text`, `review_date`, `helpful_votes`, `unhelpful_votes`, `is_spoiler`, `reviewer_name` (the display name only), `review_language`, `position`.

A field IMDb has no value for is left out of the row rather than filled with an empty value. Titles that are not out yet have no rating, and many small titles have no plot, budget or box office.

#### Stable fields for automations

`imdb_id` (titles and people) and `review_id` (reviews) never change, so they are the keys to join runs or spot new entries. `rank` and `popularity_rank` move every day; `rating` and `votes` move slowly. Join review rows to their title with `imdb_id`.

#### Output examples

A title row (cast shortened):

```json
{
  "record_type": "title",
  "imdb_id": "tt1375666",
  "url": "https://www.imdb.com/title/tt1375666/",
  "title": "Inception",
  "title_type": "Movie",
  "year": 2010,
  "release_date": "2010-07-16",
  "runtime_minutes": 148,
  "rating": 8.8,
  "votes": 2890632,
  "metascore": 74,
  "certificate": "PG-13",
  "genres": ["Adventure", "Sci-Fi", "Thriller"],
  "plot": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
  "directors": ["Christopher Nolan"],
  "writers": ["Christopher Nolan"],
  "stars": ["Leonardo DiCaprio", "Joseph Gordon-Levitt", "Elliot Page"],
  "cast": [{ "name": "Leonardo DiCaprio", "imdb_id": "nm0000138", "character": "Cobb" }],
  "cast_total": 87,
  "countries": ["United Kingdom", "United States"],
  "languages": ["English", "Japanese", "French"],
  "production_companies": ["Warner Bros.", "Legendary Pictures", "Syncopy", "Legendary Entertainment"],
  "budget": 160000000,
  "budget_currency": "USD",
  "gross_worldwide": 839796627,
  "gross_us_canada": 292587330,
  "opening_weekend_us_canada": 62785337,
  "gross_currency": "USD",
  "user_reviews_count": 5297,
  "award_wins": 160,
  "top_award": "Oscar",
  "top_award_wins": 4,
  "top_award_nominations": 4,
  "source": "link"
}
```

A review row:

```json
{
  "record_type": "review",
  "review_id": "rw10607352",
  "url": "https://www.imdb.com/review/rw10607352/",
  "imdb_id": "tt1375666",
  "title": "Inception",
  "review_rating": 10,
  "review_title": "The one that stays with you long after the movie ended.",
  "review_text": "Few films leave you genuinely questioning whether you truly understood them quite like Inception does. ...",
  "review_date": "2025-07-01",
  "helpful_votes": 217,
  "unhelpful_votes": 13,
  "is_spoiler": false,
  "reviewer_name": "Didako1221",
  "review_language": "en-US",
  "position": 1
}
```

### Pricing

Pay per event: you pay for the titles, people and reviews you receive, plus a flat $0.003 per run, whatever memory you choose. Cast, box office, awards and every other field cost nothing extra. Reviews are charged per review, only when you turn them on.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `result` | Once per title or person row stored in your dataset | $18.00 per 1,000 | $16.60 per 1,000 | $15.40 per 1,000 | $14.00 per 1,000 |
| `review` | Once per review row stored in your dataset (only with `includeReviews`) | $4.49 per 1,000 | $3.89 per 1,000 | $3.29 per 1,000 | $2.69 per 1,000 |
| `run-start` | Once per run, after the first row is ready | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one row is the price per 1,000 divided by 1,000.

Never charged:

- links that are not IMDb links, unknown chart names and ids IMDb has no title or person for (each gets an error row);
- a title or person that a second source of the same run finds again;
- rows past your `maxItems` or `maxReviewsPerTitle`;
- the summary, info and error rows;
- a run that finds nothing: the start fee is charged only once the first row is ready;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| | This actor | dtrungtin/imdb-scraper | epctex/imdb-advanced-scraper | coder_zoro/imdb-reviews-scraper |
|---|---|---|---|---|
| Users | new | 1,075 | 353 | 140 |
| Price per 1,000 rows | $18.00 Free, $14.00 Gold; reviews $4.49 to $2.69 | $20.00 | $3.20 | $4.99 Free, $2.99 Gold |
| Start fee per run | $0.003 | $0.05 | $0.00005 | $0.00005 |
| Input | Charts, keywords, filters, lists, links | Links | Keyword, links | Title links |
| Charts in rank order | 11 charts, `rank` field | Through chart links | Through links | No |
| User reviews | Yes, sort and spoiler filter | No | No | Reviews only |
| Row shape | One flat row, plain field names | Flat, text fields | Nested IMDb objects | Flat |
| Proxy needed | No | Apify Proxy | Required | Not stated |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `imdb_id` with `rank`, `rating`, `votes` and `popularity_rank` to track chart moves, or on `review_id` to collect new reviews only.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

IMDb's own data service, the one the IMDb website calls from your browser to fill its title, chart, list, search and review pages: the facts anyone sees on imdb.com without logging in. It does not log in, rate titles or read account data.

#### How many titles can I get?

Up to 10,000 per keyword, filter search or list, and the full length of each chart (250 for the Top 250 lists, 100 for Most Popular and Lowest Rated, 10 for Box Office). For a bigger catalog, split it by genre, year range or title type and run several filter searches; a title found twice is delivered once.

#### Why do some rows have no rating, plot or box office?

IMDb has no value for them. Titles that are not out yet have no rating or votes; small and very old titles often have no plot, Metascore, budget or box office; box office is mostly for films with a theatrical release. The field is left out of the row in that case.

#### Do I need an account, cookies or an API key?

No. No IMDb account, no cookies and no API key. The actor needs no proxy either; it switches to Apify's datacenter proxy by itself only if IMDb refuses direct requests.

#### Can I get reviews only?

Paste a title's reviews link (for example `https://www.imdb.com/title/tt1375666/reviews/`) or turn on `includeReviews`. Each title row is followed by its review rows. Reviews carry the reviewer's display name only.

#### What do the filters do to a keyword search?

Without filters, a keyword search returns IMDb's own results in relevance order, titles of every type. With any filter or a sort, the keyword is searched in titles with IMDb's advanced title search and the filters apply. With filters and no keyword, you get every title that matches the filters.

#### How long does a run take?

In our test runs on Apify: 3 seconds for 50 Top 250 movies, 36 seconds for 968 titles and people from 2 charts, 2 filter searches, a list, a people search and 2 links, 24 seconds for 80 titles with 578 reviews. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three views: Titles, People and Reviews. In CSV and Excel, lists such as `genres` and `cast` are flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/imdb-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http imdb-scraper "https://mcp.apify.com/?tools=themineworks/imdb-scraper"`

#### Is it legal to scrape IMDb?

The actor reads facts IMDb shows to anyone without logging in, and no personal data beyond what IMDb publishes about film professionals and the display names reviewers chose. IMDb's terms and conditions of use restrict automated collection and commercial use of its data, and IMDb offers licensed data for commercial use. Decide for yourself whether your use is acceptable. You are responsible for how you use the data and for following IMDb's terms and data protection law such as the GDPR and the CCPA. This is general information, not legal advice. IMDb is a trademark of IMDb.com, Inc.; this actor is independent and not affiliated with it.

### Integrations

- **Google Sheets**: send each run's rows to a sheet with Apify's Google Sheets integration; one row per title fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "the Top 250 every Monday into Airtable".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kwai Video Scraper](https://apify.com/themineworks/kwai-video-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Capterra Reviews Scraper](https://apify.com/themineworks/capterra-software-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LandWatch Scraper](https://apify.com/themineworks/landwatch-land-for-sale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Lens OCR Scraper](https://apify.com/themineworks/google-lens-ocr-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Hotels Prices Scraper](https://apify.com/themineworks/google-hotels-prices-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Tennis Match & Player Data Scraper](https://apify.com/themineworks/tennis-match-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

If this actor saved you time, a short rating on the Store helps other buyers find it.

### Support

Found a chart, list or search that returns fewer rows than IMDb shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Get IMDb charts, searches, lists and links back as one row per title, person or review, with rating, votes, cast, directors, box office, Metascore, awards and reviews, no login.*

# Actor input Schema

## `charts` (type: `array`):

IMDb charts to export, each in chart order with its rank. Top 250 lists hold 250 titles, Most Popular and Lowest Rated 100, Box Office the 10 films of the latest US weekend with the weekend gross.

## `searchTerms` (type: `array`):

Words to search on IMDb, one per line, as you would type them in the IMDb search box. Example: batman, breaking bad, christopher nolan. Each keyword is one search.

## `searchType` (type: `string`):

Titles (movies, TV shows, episodes, games) or people (actors, directors, writers). Filters below apply to title searches only.

## `startUrls` (type: `array`):

IMDb links or ids, one per line: a title (https://www.imdb.com/title/tt0111161/ or tt0111161), its reviews page, a person (/name/nm0634240/), a public list (/list/ls055592025/), a chart (/chart/top/, /chart/moviemeter/, /chart/toptv/, /chart/boxoffice/), a find link (/find/?q=dune) or an advanced search link (/search/title/?genres=horror\&title_type=feature).

## `maxItems` (type: `integer`):

The most rows to return for each chart, keyword, filter search, list or search link, 1 to 10,000. Single title and name links always return their row.

## `titleTypes` (type: `array`):

Only these kinds of titles. Empty means all. Using any filter switches keyword searches to IMDb's advanced title search.

## `genres` (type: `array`):

Only titles that have ALL these genres. Empty means any genre.

## `releaseYearFrom` (type: `integer`):

Only titles released in or after this year, for example 2015.

## `releaseYearTo` (type: `integer`):

Only titles released in or before this year, for example 2024.

## `minRating` (type: `number`):

Only titles rated at least this, 1 to 10, for example 7.5.

## `minVotes` (type: `integer`):

Only titles with at least this many IMDb ratings, for example 10000. Useful with a rating filter or rating sort to skip obscure titles.

## `countries` (type: `array`):

Two letter country codes, for example US, GB, IN, KR. Only titles from any of these countries.

## `languages` (type: `array`):

Two letter language codes, for example en, hi, ko, es. Only titles in any of these languages.

## `sortBy` (type: `string`):

Order of filter search results. Keyword searches without filters keep IMDb's own relevance order.

## `castLimit` (type: `integer`):

How many cast members (with character names) to keep in each title row, 0 to 100. The first three also fill the stars field.

## `includeReviews` (type: `boolean`):

On: each title also returns up to the number of reviews below, one row per review (rating, headline, text, date, helpful votes, spoiler flag, reviewer display name). Reviews are charged per review row.

## `maxReviewsPerTitle` (type: `integer`):

Up to how many reviews to return for each title, 1 to 5,000.

## `reviewsSort` (type: `string`):

Which reviews come first.

## `excludeSpoilers` (type: `boolean`):

On: reviews the author marked as containing spoilers are left out.

## Actor input object example

```json
{
  "charts": [
    "top-250-movies"
  ],
  "searchType": "titles",
  "maxItems": 50,
  "castLimit": 15,
  "includeReviews": false,
  "maxReviewsPerTitle": 20,
  "reviewsSort": "helpful",
  "excludeSpoilers": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "charts": [
        "top-250-movies"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/imdb-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "charts": ["top-250-movies"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/imdb-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "charts": [
    "top-250-movies"
  ],
  "maxItems": 50
}' |
apify call themineworks/imdb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/imdb-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5mpPKweghERqt9CWa/builds/t2z6pP86gyPKBTulN/openapi.json
