# IMDb Scraper - Movies, TV, People and Charts (`lentic_clockss/imdb-scraper`) Actor

Extract IMDb titles, ratings, cast, people and Top 250 chart rows: search results, film and series details and person profiles as structured rows. Pay per delivered row plus a start fee.

- **URL**: https://apify.com/lentic_clockss/imdb-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Social media, Videos, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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

**Extract IMDb search results, film and series details, person profiles and the IMDb Top 250 chart as structured rows you can export.**

- Titles with their IMDb rating, vote count, year, type, certificate, genres, plot and poster.
- Directors and stars with their IMDb name IDs, so you can follow a title to its people.
- Person rows with professions, birth and death dates, biography and the titles they are known for.
- The IMDb Top 250 films with their chart rank.
- Pay only for the rows you receive: $3.00 per 1,000 rows on the Free plan plus a small start fee.

### What does IMDb Scraper do?

IMDb Scraper reads what IMDb publishes for visitors and turns it into one row per film, series, person or chart entry. No login and no IMDb account of yours is involved.

- **Search** (`keywords`): what IMDb's search box returns for a title, a person's name or a keyword. Titles, people and other matches (keywords, companies, interests) each come back as their own row.
- **Title details** (`titleIds`): one row per film, series or episode, with ratings, runtime, awards totals, keywords, countries and languages.
- **Person details** (`nameIds`): one row per actor, director, writer or other person.
- **Chart** (`chartIds`): the IMDb Top 250 films, one row per ranked title.
- **Adult titles** (`includeAdult`): off by default; switch it on to let search results include titles IMDb marks as adult.

Filling one target field picks the view automatically. Every row is one entity: a person is never folded into a title row, and a chart entry carries its own rank.

### What data can you extract from IMDb?

Fields depend on the row type and on what IMDb publishes for that title or person. A value IMDb does not show stays empty or `null`; nothing is guessed.

#### Title rows (`rowType`: `title`)

| Field | Description | Example |
| --- | --- | --- |
| `id` | IMDb title ID | `tt0111161` |
| `title` | Title as IMDb shows it | `The Shawshank Redemption` |
| `originalTitle` | Original-language title (title details) | `The Shawshank Redemption` |
| `titleType` | Film, TV series, episode and so on | `Movie` |
| `releaseYear` | Release year | `1994` |
| `endYear` | Last year of a series, `null` for films | `null` |
| `runtimeSeconds` | Running time in seconds (title details) | `8520` |
| `rating` | IMDb user rating out of 10 | `9.3` |
| `voteCount` | Number of IMDb user votes | `3000000` |
| `certificate` | Age rating | `R` |
| `metascore` | Metacritic score, when IMDb shows one | `82` |
| `plot` | Short plot summary | `A banker convicted of uxoricide forms a friendship…` |
| `genres` | Genre list | `["Drama"]` |
| `image` | Poster with URL, width and height (plus a caption on title details) | `{"url": "https://m.media-amazon.com/images/…jpg", "width": 1200, "height": 1800}` |
| `directors` | Directors with their IMDb name IDs | `[{"id": "nm0001104", "name": "Frank Darabont"}]` |
| `stars` | Leading cast with their IMDb name IDs | `[{"id": "nm0000209", "name": "Tim Robbins"}]` |
| `winsTotal`, `nominationsTotal` | Award wins and nominations (title details) | `21`, `43` |
| `keywords` | Plot keywords (title details) | `["prison", "friendship"]` |
| `countriesOfOrigin` | Countries of origin (title details) | `["United States"]` |
| `spokenLanguages` | Spoken languages (title details) | `["English"]` |

#### Person rows (`rowType`: `name`)

| Field | Description | Example |
| --- | --- | --- |
| `id` | IMDb name ID | `nm0000209` |
| `name` | Name as IMDb shows it | `Tim Robbins` |
| `professions` | What the person is known as | `["Actor", "Director", "Writer"]` |
| `image` | Profile photo | `{"url": "https://m.media-amazon.com/images/…jpg", "width": 800, "height": 1200}` |
| `known_for` | IMDb title IDs the person is best known for | `["tt0111161", "tt0325980"]` |
| `birthDate`, `deathDate` | Dates IMDb publishes (person details) | `1958-10-16` |
| `bio` | Biography text (person details) | `Born in West Covina, California…` |
| `winsTotal`, `nominationsTotal` | Award wins and nominations (person details) | `2`, `10` |
| `totalCredits` | Number of credits IMDb lists (person details) | `120` |

#### Chart rows (`rowType`: `chart_entry`)

A chart row carries the search-level title fields above (`id`, `title`, `titleType`, `releaseYear`, `endYear`, `rating`, `voteCount`, `certificate`, `plot`, `genres`, `image`, `metascore`, `directors`, `stars`) plus `rank`, the position in the chart (for example `1`), and `chartId` (`top`).

#### Other search rows (`rowType`: `search_hit`)

| Field | Description | Example |
| --- | --- | --- |
| `id` | IMDb ID of the match | `kw0001234` |
| `title` | The keyword, company or interest name | `prison escape` |
| `kind` | What kind of match it is | `Keyword` |

Every row also carries `rowType`, `scrapedAt` and `source`, which says where the row came from: `find` (search), `chart` (a chart), `ssr` (a title or person page) or `input` (only the ID you gave, when the page could not be read). Search rows carry `searchTerm`, the term that found them.

### How to scrape IMDb

1. Open the Actor in Apify Console. A free Apify account is enough to try it.
2. Fill one target: search terms, title IDs, name IDs or charts.
3. Set `maxResults` to `3` for a small first run.
4. Click **Start** and wait for the run to finish.
5. Download the dataset or read it through the Apify API.

An empty input `{}` starts an example search for `The Shawshank Redemption`, limited to 3 rows. That is a normal priced run, not a free preview. The form prefills use the same example.

With `mode` on Automatic, the field you filled picks the view. Search terms win over title IDs, which win over name IDs, which win over charts. `INPUT_REPORT` records which view ran and what was ignored.

#### Search

Enter one or more terms in `keywords`. Each term is its own input with its own row allowance. Results come back in the order IMDb ranks them. A term that matches nothing ends as a successful empty run with `emptyReason: NO_MATCH`, which has no row charge.

#### Title details

Put IDs in `titleIds`. A full IMDb link such as `https://www.imdb.com/title/tt0111161/` works as well as the bare `tt0111161`, and duplicates are removed. Each ID gives one row.

#### Person details

Put IDs in `nameIds`, bare (`nm0000209`) or as links. Each ID gives one row.

#### Chart

Put `top` in `chartIds` for the IMDb Top 250 films. The chart has 250 entries; `maxResults` caps how many you take, starting from rank 1. Pass the `nextCursor` value back as `cursor` to read further down the chart.

### What to fill in

| Field | What to enter | Default |
| --- | --- | --- |
| `keywords` | One or more search terms: titles, names or keywords | Empty; form sample `The Shawshank Redemption` |
| `titleIds` | IMDb title IDs (`tt…`) or `/title/` links | Empty |
| `nameIds` | IMDb name IDs (`nm…`) or `/name/` links | Empty |
| `chartIds` | `top` for the IMDb Top 250 films | Empty |
| `mode` | `auto`, `search`, `titles`, `names`, `chart` | `auto` |
| `maxResults` | Rows per input, `1` to `70` | `70`; form sample `3` |
| `includeAdult` | Let search results include adult titles | `false` |
| `cursor` | An earlier `RUN_SUMMARY.nextCursor` | Empty |

Search:

```json
{"keywords": ["The Shawshank Redemption"], "maxResults": 3}
```

Title details:

```json
{"titleIds": ["tt0111161", "https://www.imdb.com/title/tt0068646/"], "maxResults": 1}
```

Person details:

```json
{"nameIds": ["nm0000209"], "maxResults": 1}
```

Top 250 chart:

```json
{"chartIds": ["top"], "maxResults": 10}
```

- `maxItems` and `limit` are accepted aliases for `maxResults`.
- Unknown fields do not fail input resolution. Close misspellings can be corrected; others are ignored with a note.
- Input errors arrive as `INVALID_INPUT: <field> — <how to fix>`, before any row is collected or charged. The start fee is separate.
- `INPUT_REPORT` in the run's key-value store records which fields were filled, normalized, inferred or ignored, including whether the example ran.

### Output example

Illustrative chart row, shortened to the main fields; the values are examples, not a freshly collected title:

```json
{
  "rowType": "chart_entry",
  "id": "tt0111161",
  "rank": 1,
  "chartId": "top",
  "title": "The Shawshank Redemption",
  "titleType": "Movie",
  "releaseYear": 1994,
  "endYear": null,
  "rating": 9.3,
  "voteCount": 3000000,
  "certificate": "R",
  "genres": ["Drama"],
  "directors": [{"id": "nm0001104", "name": "Frank Darabont"}],
  "stars": [{"id": "nm0000209", "name": "Tim Robbins"}],
  "source": "chart",
  "scrapedAt": "2026-10-27T08:00:00+00:00"
}
```

You can export the dataset as JSON, CSV, Excel, XML, RSS or an HTML table.

### Why use this IMDb scraper?

- **Pay per delivered row.** A title, a person and a chart entry each cost the same and are counted separately.
- **Linked IDs.** Directors, stars and known-for titles carry their IMDb IDs, so you can feed them straight into a follow-up run.
- **Useful partial results.** If one title or person cannot be read, the rows already collected are still delivered with a warning that says what was left out.
- **No made-up data.** A field IMDb does not publish stays empty instead of being filled with a guess.
- **Several inputs per run.** Several search terms or IDs run in one go, each with its own allowance.
- **No setup.** You do not need proxies, cookies or an IMDb account.

### How much does it cost to scrape IMDb?

The Actor uses pay-per-event pricing. The start event costs **$0.005**, charged once per GB of run memory with a minimum of one event. At the default **1,024 MB**, one start costs **$0.005**. Platform usage is included in these prices.

| Apify plan | Price per row | Price per 1,000 rows |
| --- | --- | --- |
| Free | $0.0030 | $3.00 |
| Starter | $0.0030 | $3.00 |
| Scale | $0.0026 | $2.60 |
| Business | $0.0022 | $2.20 |
| Platinum | $0.0022 | $2.20 |
| Diamond | $0.0022 | $2.20 |

`maxResults` applies to each input: each search term, title ID, name ID or chart. Its default is 70, not a promise of 70 matches. A larger request is collected in parts of 70.

Free Apify plan runs are capped at **200 rows**, with **10 runs of this Actor** in total. Paid plans remove the run-count limit, but row limits, what IMDb publishes and your spending limit still apply. The whole run is capped by **Maximum cost per run** (`maxTotalChargeUsd` in the API).

Example: the first 10 titles of the Top 250 on the Free plan cost `10 × $0.003 + $0.005 = $0.035`. A run with no rows has no row charge; it can still incur the start fee.

- The Apify Free plan includes **$5.00** in monthly usage credit (about **1,666 rows** at `$0.003` per row across Free-plan runs capped at 200 rows per run).

### Use with AI agents and the API

AI agents can start this Actor and read its rows through the Apify API, the same way as any other client.

#### Apify MCP server (Claude, ChatGPT, Cursor, VS Code)

Add this Actor to a client that supports remote MCP servers:

```text
https://mcp.apify.com?tools=lentic_clockss/imdb-scraper
```

Sign in with Apify using OAuth when prompted, or send `Authorization: Bearer <YOUR_APIFY_TOKEN>`. The tool returns run and dataset IDs; the agent can read rows with `get-dataset-items`. Enable that tool in the MCP client too if it is not already available.

Clients without remote MCP support can run `npx @apify/actors-mcp-server --tools lentic_clockss/imdb-scraper` with `APIFY_TOKEN` set.

- **Agent execution note:** Set `maxResults` between `5` and `20` on exploratory tool calls to keep responses compact, and read `RUN_SUMMARY` and `INPUT_REPORT` from the default key-value store to inspect normalized inputs and delivered row counts.

#### Apify API

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("lentic_clockss/imdb-scraper").call(
    run_input={"titleIds": ["tt0111161"], "maxResults": 1}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

JavaScript:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('lentic_clockss/imdb-scraper').call({
    titleIds: ['tt0111161'], maxResults: 1
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

For HTTP, send the JSON input to `POST https://api.apify.com/v2/acts/lentic_clockss~imdb-scraper/runs`, with `Authorization: Bearer <YOUR_APIFY_TOKEN>`. After completion, read `GET https://api.apify.com/v2/datasets/<datasetId>/items?format=json`, using the run's `defaultDatasetId`.

#### Integrations

Use Apify integrations with Google Sheets, Make, Zapier, n8n, Slack or Airtable, or connect a webhook. Use Apify Schedules for recurring runs, for example a weekly copy of the Top 250.

### FAQ

#### Is it legal to scrape IMDb?

This Actor collects information IMDb publishes to visitors. You are responsible for checking IMDb's terms of use and the data-protection law that applies to you. Person rows describe public figures, but personal data still needs a lawful basis for collection and use; public visibility alone does not settle that question.

#### Why did my run end as ABORTED?

Check the run log and status message to see why it stopped, including whether it was aborted by hand. An aborted run may have delivered rows already, so look at the dataset before starting another.

#### How many results can I get?

`maxResults` is the row limit for each input, default 70. One title ID or name ID gives one row; a search term gives as many matches as IMDb returns, up to the limit; the Top 250 chart gives up to 250 rows across continued runs. The Free plan caps a run at 200 rows, and your maximum cost can stop a run earlier.

#### Why are some fields empty?

IMDb does not publish every field for every title or person. A new release may have no rating yet, a film may have no Metacritic score, and a person may have no published birth date. Search and chart rows also carry fewer fields than title and person details. Empty means "not published", not "not collected".

#### What is the difference between a search row and a title details row?

A search row is what IMDb's search list shows: title, year, rating, genres and poster. A title details row reads the title's own page and adds runtime, awards totals, keywords, countries and languages. Use search to find IDs, then `titleIds` for the full row.

#### Can I continue a long search or the chart?

Pass the `RUN_SUMMARY.nextCursor` value back as `cursor` with the same input. A cursor continues that input only, and it is left out when the maximum cost stopped delivery early.

#### Do I need an IMDb account?

No. The Actor reads what IMDb shows to visitors and never rates, reviews or adds anything to a list on your behalf.

### Limitations

- Only the IMDb Top 250 films chart is supported in `chartIds` for now.
- User reviews, full cast lists, box office figures and episode guides are not collected.
- Fields follow what IMDb publishes today. A layout change can leave a field empty until the Actor is updated.
- Ratings, vote counts and chart ranks change over time; each row reflects the moment of the run.
- When a title or person page cannot be read, its row carries only `id`, `url` and `source: input`, with a warning in the run summary, so the ID is not lost.
- IMDb occasionally refuses a visitor for a while. The Actor reports that as a failed input with a clear reason; running again later usually works.

### Related scrapers

More social media and video scrapers from the same publisher:

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Douban Scraper](https://apify.com/lentic_clockss/douban-scraper)
- [Telegram Channel Scraper](https://apify.com/lentic_clockss/telegram-channel-scraper)
- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Validator](https://apify.com/lentic_clockss/email-risk-validator)

Browse all of our scrapers at [apify.com/lentic_clockss](https://apify.com/lentic_clockss).

### Support

Found a problem or need another field? Open an issue in the **Issues** tab of this Actor's page and include the run ID and the input you used.

# Actor input Schema

## `keywords` (type: `array`):

Anything you would type into IMDb's search box: a film or series title, a person's name or a keyword. Each term is one input, and maxResults applies to each of them.

## `titleIds` (type: `array`):

IMDb title IDs such as tt0111161, or full links such as https://www.imdb.com/title/tt0111161/. One row per title. Used only when the search field is empty.

## `nameIds` (type: `array`):

IMDb person IDs such as nm0000209, or full links such as https://www.imdb.com/name/nm0000209/. One row per person.

## `chartIds` (type: `array`):

IMDb charts to read, one row per ranked title. Currently supported: top (the IMDb Top 250 films).

## `mode` (type: `string`):

Leave on Automatic unless you want to force one data view. Automatic picks the view from the field you filled.

## `maxResults` (type: `integer`):

Rows delivered and billed for each input (each search term, ID or chart). Default 70.

## `includeAdult` (type: `boolean`):

Let search results include titles IMDb marks as adult. Off by default.

## `cursor` (type: `string`):

Leave empty. To read further, pass the nextCursor value from a previous run's RUN_SUMMARY with the same input.

## Actor input object example

```json
{
  "keywords": [
    "The Shawshank Redemption"
  ],
  "mode": "auto",
  "maxResults": 3,
  "includeAdult": false
}
```

# Actor output Schema

## `rows` (type: `string`):

Title, person, chart and search rows from this run.

## `runSummary` (type: `string`):

Run status, delivered row count, warnings and the continuation cursor when more rows remain.

## `inputEcho` (type: `string`):

Input settings used for the run, including applied row limits.

## `inputReport` (type: `string`):

Every input change the resolver made: aliases, inferred mode, example run, ignored fields.

## `errorSummary` (type: `string`):

Failure type and message when the Actor records an error.

# 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 = {
    "keywords": [
        "The Shawshank Redemption"
    ],
    "maxResults": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/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 = {
    "keywords": ["The Shawshank Redemption"],
    "maxResults": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/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 '{
  "keywords": [
    "The Shawshank Redemption"
  ],
  "maxResults": 3
}' |
apify call lentic_clockss/imdb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lentic_clockss/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/7NMVHO4AKY7cRMOHV/builds/fogj9VXixK34PxjSV/openapi.json
