IMDb Search Scraper

IMDb Search Scraper: resolve a name to an IMDb ID, for titles and people

Type breaking bad or tom hanks and get back the IMDb ID, the title or name, what kind of thing it is, the year, the stars or known-for line, the poster or headshot, IMDb's popularity rank and the imdb.com URL. No API key, no account.

Read this bit before you build on it: this is the index behind IMDb's own search box, so about 8 results come back per query and there is no page two. No ratings, no vote counts, no genre, no runtime, no plot. It is very good at turning a name into an ID, which is usually the first thing you need, and it is the wrong tool for full title metadata.

🔍 What IMDb Search Scraper does

It searches the same index IMDb's own search box uses. One term in query, or a list in queries, or both at once. Every term is searched separately and the rows are merged and deduplicated on IMDb ID, so inception and the matrix in one run come back as one clean list.

That list is the only way past the per-query ceiling. Setting maxItems to 200 does not turn one term into 200 rows, because the index hands out about 8 and offers no pagination. Twenty-five terms will get you there; one term will not.

Titles, people and companies all come back. type narrows it to one of the first two.

Links work too. Paste title or name pages into startUrls and each one comes back as exactly that title or person, one row per link. Handy when you already have the pages and want the clean ID, year and poster in a table.

📥 What you give it

{
  "queries": ["inception", "the matrix", "arrival"],
  "type": "titles",
  "maxItems": 50
}

Send none of query, queries or startUrls and the run returns a BAD_INPUT row instead of results.

📤 What you get back

A real row from a recent run, trimmed where the poster URL runs long:

{
  "ok": true,
  "id": "tt0903747",
  "kind": "title",
  "title": "Breaking Bad",
  "category": "TV series",
  "year": 2008,
  "yearRange": "2008-2013",
  "starsOrKnownFor": "Bryan Cranston, Aaron Paul",
  "rank": 46,
  "image": "https://m.media-amazon.com/images/M/MV5BOWE4NTc3YmYt...jpg",
  "url": "https://www.imdb.com/title/tt0903747/"
}

🧾 Reading the output

Two kinds of row land in your dataset.

Other diagnostics carry their own errorCode in the same shape. One thing to know about multi-term runs: if some terms work and others fail, the failures show up in the run log rather than as rows, so compare the row count against the number of terms you sent.

▶️ How to run it

1. Open IMDb Search Scraper and click Try for free. 2. Type one thing into Search query, paste a list into Multiple queries, or paste pages into IMDb links. 3. Set Result type if you only want titles or only people. 4. Leave Max results alone for a first run, then click Start. 5. Download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$2.50 per 1,000 rows. Flat on every Apify plan, no volume tiers.

You pay per row delivered. Duplicates removed across your terms are not charged, diagnostic rows are not charged, and if nothing is found, no rows are charged. Since a term returns about 8 rows, a 20-term run lands near 160 rows.

💡 What people use it for

• Turning a spreadsheet of film or show names into IMDb IDs, so the rest of a pipeline has a key to

join on.

• Checking that a title people typed by hand actually exists, and catching the ones that matched

nothing.

• Pulling posters and headshots for a set of titles or actors without touching a page.
• Ranking a shortlist by rank to see which of them anyone is actually looking up.

🚧 What it does not do

• No ratings, vote counts, genres, runtime, plot or full cast. Those live on the title page,

which this does not read.

• About 8 rows per query, and no second page. More rows means more terms, not a bigger

maxItems.

• type filters on the ID prefix only. It is not a search-side filter, so narrowing can empty a

run that did find things.

• Companies are only returned under type: "all".
• A kind: "other" row has no url. Franchise-style entries have no page of their own.
• Search ranking is IMDb's. This actor does not re-order what comes back.
• No watchlists, no reviews, no box office.

🧭 Which reference scraper do you need?

❓ Questions people ask

Can I get a film's rating out of this? No. The index behind IMDb's search box does not carry ratings, and neither does this actor.

Why did I only get 8 rows? That is the ceiling per term. Put more terms into queries.

Do repeated terms cost me twice? No. Terms that differ only in capitalisation are searched once, and identical IDs across terms are merged before anything is charged.

Can I search people and titles at once? Yes, that is what type: "all" does. It is the default.

Can I schedule it? Yes, like any Apify actor. A saved list of terms in queries makes it repeatable.

Is scraping IMDb search results legal? These are public search results. They can still describe real people, which GDPR and similar laws cover, so have a reason for collecting them. Apify's write-up on scraping and the law is a good place to start, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the terms you searched and the run ID. The errorCode on the diagnostic row usually names the problem on its own.