IMDb Scraper - Movies, TV, People and Charts
Pricing
from $2.10 / 1,000 results
IMDb Scraper - Movies, TV, People and Charts
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.
Pricing
from $2.10 / 1,000 results
Rating
0.0
(0)
Developer
kane liu
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Features
Share
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
- Open the Actor in Apify Console. A free Apify account is enough to try it.
- Fill one target: search terms, title IDs, name IDs or charts.
- Set
maxResultsto3for a small first run. - Click Start and wait for the run to finish.
- 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:
{"keywords": ["The Shawshank Redemption"], "maxResults": 3}
Title details:
{"titleIds": ["tt0111161", "https://www.imdb.com/title/tt0068646/"], "maxResults": 1}
Person details:
{"nameIds": ["nm0000209"], "maxResults": 1}
Top 250 chart:
{"chartIds": ["top"], "maxResults": 10}
maxItemsandlimitare accepted aliases formaxResults.- 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_REPORTin 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:
{"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.003per 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:
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
maxResultsbetween5and20on exploratory tool calls to keep responses compact, and readRUN_SUMMARYandINPUT_REPORTfrom the default key-value store to inspect normalized inputs and delivered row counts.
Apify API
Python:
from apify_client import ApifyClientclient = 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:
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
chartIdsfor 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,urlandsource: 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
- Reddit Scraper
- YouTube Shorts Scraper
- YouTube Scraper
- Douban Scraper
- Telegram Channel Scraper
- Stealth Web Scraper
- Email Validator
Browse all of our scrapers at 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.
