IMDb Scraper - Movies, TV, People and Charts avatar

IMDb Scraper - Movies, TV, People and Charts

Pricing

from $2.10 / 1,000 results

Go to Apify Store
IMDb Scraper - Movies, TV, People and Charts

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

kane liu

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Features

Limited permissions

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)

FieldDescriptionExample
idIMDb title IDtt0111161
titleTitle as IMDb shows itThe Shawshank Redemption
originalTitleOriginal-language title (title details)The Shawshank Redemption
titleTypeFilm, TV series, episode and so onMovie
releaseYearRelease year1994
endYearLast year of a series, null for filmsnull
runtimeSecondsRunning time in seconds (title details)8520
ratingIMDb user rating out of 109.3
voteCountNumber of IMDb user votes3000000
certificateAge ratingR
metascoreMetacritic score, when IMDb shows one82
plotShort plot summaryA banker convicted of uxoricide forms a friendship…
genresGenre list["Drama"]
imagePoster with URL, width and height (plus a caption on title details){"url": "https://m.media-amazon.com/images/…jpg", "width": 1200, "height": 1800}
directorsDirectors with their IMDb name IDs[{"id": "nm0001104", "name": "Frank Darabont"}]
starsLeading cast with their IMDb name IDs[{"id": "nm0000209", "name": "Tim Robbins"}]
winsTotal, nominationsTotalAward wins and nominations (title details)21, 43
keywordsPlot keywords (title details)["prison", "friendship"]
countriesOfOriginCountries of origin (title details)["United States"]
spokenLanguagesSpoken languages (title details)["English"]

Person rows (rowType: name)

FieldDescriptionExample
idIMDb name IDnm0000209
nameName as IMDb shows itTim Robbins
professionsWhat the person is known as["Actor", "Director", "Writer"]
imageProfile photo{"url": "https://m.media-amazon.com/images/…jpg", "width": 800, "height": 1200}
known_forIMDb title IDs the person is best known for["tt0111161", "tt0325980"]
birthDate, deathDateDates IMDb publishes (person details)1958-10-16
bioBiography text (person details)Born in West Covina, California…
winsTotal, nominationsTotalAward wins and nominations (person details)2, 10
totalCreditsNumber 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)

FieldDescriptionExample
idIMDb ID of the matchkw0001234
titleThe keyword, company or interest nameprison escape
kindWhat kind of match it isKeyword

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.

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

FieldWhat to enterDefault
keywordsOne or more search terms: titles, names or keywordsEmpty; form sample The Shawshank Redemption
titleIdsIMDb title IDs (tt…) or /title/ linksEmpty
nameIdsIMDb name IDs (nm…) or /name/ linksEmpty
chartIdstop for the IMDb Top 250 filmsEmpty
modeauto, search, titles, names, chartauto
maxResultsRows per input, 1 to 7070; form sample 3
includeAdultLet search results include adult titlesfalse
cursorAn earlier RUN_SUMMARY.nextCursorEmpty

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}
  • 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:

{
"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 planPrice per rowPrice 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:

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:

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:

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

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.

More social media and video scrapers from the same publisher:

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.