IMDb Scraper — Ratings, Cast, Box Office, Awards & Top 250 🎬

🎉 One enriched row per title — ratings, full cast, box office AND awards, merged in a single call

Built for data teams, researchers and app builders who need clean, structured IMDb data — by ID or URL, no login, no rental.

---

📋 Overview

Turn any IMDb title into a clean structured dataset. Feed a title ID or an IMDb URL and get back one enriched row per title — ratings, Metacritic, certificate, runtime, genres, plot, billed cast, box-office grosses and awards. Or pull the entire Top 250 chart, or mine featured user reviews. Export JSON, CSV or Excel in seconds.

Why data teams choose this scraper:

• ✅ One row, every field: ratings, full billed cast with characters, box office AND awards merged into a single row — the fields other scrapers split across separate tools.
• ⚡ ID or URL in, clean data out: paste tt0111161 or https://www.imdb.com/title/tt0111161/ — the title ID is parsed for you. Single or bulk.
• 🎯 Top 250 charts: export the full Top 250 Movies or Top 250 TV ranking — rank, rating and votes per row — in one call.
• 💰 Pay-per-result, best-in-class price: only pay for rows you receive. No $50/month rental, no login, no API key.
• 💎 Box office + awards moat: budget, opening weekend, domestic & worldwide gross, total wins, nominations and Oscar counts — data most IMDb scrapers leave out.
• ✨ Movie & TV, worldwide: films, series, episodes and shorts, localized across 11 language/country options.

---

✨ Features

• 🎞️ Enriched Title Profile: ratings, Metacritic, certificate, runtime, genres, plot, watchlist size and production status — one row per title.
• 🌟 Full Billed Cast: principal cast with the characters they play, plus the top cast list and total cast-credit count.
• 💰 Box Office: budget, opening-weekend gross with date, domestic gross and worldwide gross, with currency.
• 🏆 Awards & Oscars: total wins and nominations plus prestigious-award (Oscar) wins and nominations, and all-time ranking.
• 🏅 Top 250 Charts: export the Top 250 Movies or Top 250 TV chart — 250 ranked titles per run.
• 📝 Featured User Reviews: full review text, summary, author rating, helpful up/down votes, date and spoiler flag.
• 🚀 Single or Bulk: process one title or thousands — IDs or IMDb URLs, de-duplicated automatically.
• 🌐 Localized Output: 11 language/country presets (English, French, German, Hindi, Italian, Portuguese, Spanish).
• 📤 Clean Exports: JSON, CSV, Excel and API — ready for spreadsheets, databases and pipelines.

---

🎬 Quick Start

Pick an operation, provide a title ID (or a chart), and run. Results land in a structured dataset you can export or pull via API. No account on any third-party site required.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~imdb-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"operation": "titleProfile", "titleId": "tt0111161"}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose an operation

Pick Title Profile (enriched dossier), Chart Rankings (Top 250), or Title Reviews (featured reviews).

Step 2: Provide input

For Title Profile / Reviews, paste a title ID (tt0111161) or an IMDb URL — single or bulk. For Chart Rankings, choose Top 250 Movies or Top 250 TV.

Step 3: Run and export

Start the run and download your data as JSON, CSV or Excel — or pull it straight from the API.

That's it! In under a minute, you'll have:

• Clean, structured IMDb rows with 40+ fields
• Ratings, cast, box office and awards in one place
• Data ready for analysis, apps and pipelines

---

📥 Input Configuration

Field	Type	Required	Description
operation	string	No	titleProfile (default), chartRankings, or titleReviews
titleId	string	No	A single IMDb title ID (tt0111161) or title URL
titleIds	array	No	Many title IDs or URLs for bulk processing
chart	string	No	TOP_250 (default) or TOP_250_TV — for Chart Rankings
includeCast	boolean	No	Add billed cast to each Title Profile row (default true)
includeBoxOffice	boolean	No	Add box-office data to each Title Profile row (default true)
includeAwards	boolean	No	Add awards data to each Title Profile row (default true)
includeDetails	boolean	No	Add countries, languages and links (default false)
languageCountry	string	No	Localization preset (default en_US)
maxResults	integer	No	Optional cap on rows per run

Enriched title profile:

{
  "operation": "titleProfile",
  "titleId": "tt0111161",
  "includeCast": true,
  "includeBoxOffice": true,
  "includeAwards": true
}

Bulk titles (IDs or URLs):

{
  "operation": "titleProfile",
  "titleIds": ["tt0111161", "https://www.imdb.com/title/tt0068646/", "tt0903747"]
}

Top 250 chart:

{ "operation": "chartRankings", "chart": "TOP_250" }

---

📤 Output

Results are saved to the Apify dataset with 40+ fields including:

Field	Type	Description
imdbId	string	IMDb title ID (tt…)
movieTitle	string	Title text
titleTypeText	string	Movie, TV Series, etc.
releaseYear	number	Release year
ratingValue	number	Aggregate IMDb rating
ratingCount	number	Vote count
metacriticScore	number	Metacritic metascore
topRank	number	Chart / all-time rank
genres	array	Genre labels
plot	string	Plot summary
stars	array	Billed cast (name + character + photo)
castCreditTotal	number	Total cast credits
budgetAmount	number	Production budget
worldwideGross	number	Worldwide box-office gross
totalWins	number	Total award wins
prestigiousAward	string	Top award (e.g. Oscar)
reviewText	string	Full user-review text (Title Reviews)

Example (Title Profile):

{
  "operation": "titleProfile",
  "imdbId": "tt0111161",
  "movieTitle": "The Shawshank Redemption",
  "releaseYear": 1994,
  "titleTypeText": "Movie",
  "ratingValue": 9.3,
  "ratingCount": 3209429,
  "metacriticScore": 82,
  "certificate": "R",
  "runtimeMinutes": 142,
  "genres": ["Epic", "Prison Drama", "Drama"],
  "stars": [{ "name": "Tim Robbins", "character": "Andy Dufresne", "personId": "nm0000209" }],
  "budgetAmount": 25000000,
  "worldwideGross": 29423730,
  "totalWins": 21,
  "totalNominations": 43,
  "prestigiousAward": "Oscar",
  "prestigiousNominations": 7,
  "imdbUrl": "https://www.imdb.com/title/tt0111161/"
}

---

💼 Use Cases & Examples

1. Movie & TV Metadata Enrichment

Data teams and app builders filling a content catalog with authoritative IMDb fields.

Input: A list of title IDs or IMDb URLs Output: One enriched row per title — ratings, cast, genres, runtime, box office, awards Use: Populate a media database or streaming catalog without hand-collecting fields.

2. Box-Office & Awards Research

Analysts and journalists studying film performance and reception.

Input: Title IDs of the films you're studying Output: Budget, opening weekend, domestic & worldwide gross, wins, nominations, Oscar counts Use: Build box-office models and awards-season datasets with fields most tools omit.

3. Ratings & Review Sentiment Analysis

Researchers and data scientists modeling audience reception.

Input: Title IDs (Title Reviews) or a list of titles (Title Profile) Output: Aggregate ratings, Metacritic, and featured reviews with text, rating and helpful votes Use: Feed sentiment models and reception dashboards.

4. Recommendation & Discovery Datasets

ML engineers training recommendation engines and discovery apps.

Input: Bulk title IDs Output: Genres, cast, ratings, runtime and metadata per title Use: Train models or benchmark a catalog against IMDb data.

5. Top 250 Chart Tracking

Content strategists and media analysts monitoring the all-time rankings.

Input: chartRankings with Top 250 Movies or Top 250 TV Output: 250 ranked rows — rank, title, year, rating, votes Use: Schedule daily runs to track how the rankings shift over time.

6. Competitive & Market Intelligence

Studios and agencies benchmarking titles and franchises.

Input: Titles across competitors or a franchise Output: Ratings, box office, awards and cast in one comparable table Use: Feed market-intelligence reports and pitch decks.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/imdb-scraper').call({
  operation: 'titleProfile',
  titleId: 'tt0111161'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/imdb-scraper').call(
    run_input={'operation': 'chartRankings', 'chart': 'TOP_250'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~imdb-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "titleReviews", "titleId": "tt0111161"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle JSON results
4. Action: Save to a sheet/DB, notify, or transform

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• Up to 5 rows per run — full feature access, same data quality
• No credit card required
• Perfect for testing and small samples

PAID Tier (Production Ready)

• Unlimited rows per run
• Bulk titles and full Top 250 charts
• Pay-per-result: only charged for successful rows

💰 Best price on the market — transparent pay-per-event, no monthly rental, no API key.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: Can I search IMDb by keyword? A: This actor works by title ID or IMDb URL (and the Top 250 charts), not free-text search. Grab the tt… ID from any IMDb page and paste it — or the full URL.

Q: How many titles can I process? A: FREE tier returns up to 5 rows per run. PAID tier is unlimited — bulk titles and full charts.

Q: Does it cover TV shows as well as movies? A: Yes — movies, TV series, episodes and shorts, plus a Top 250 TV chart.

Q: What box-office and awards data do I get? A: Budget, opening-weekend gross, domestic and worldwide gross, plus total wins, nominations and Oscar counts.

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset, or pull via API.

Q: Is this legal? A: Yes — the actor only extracts publicly available data. See the legal section below.

---

🐛 Troubleshooting

"No valid IMDb title ID found"

• Make sure the input contains a tt ID (e.g. tt0111161) or a full IMDb title URL.
• For Chart Rankings, no ID is needed — set operation to chartRankings.

"Title not found"

• The tt ID may be invalid or removed. Verify it opens on imdb.com.

Only 5 rows returned

• You're on the FREE tier (capped at 5 rows). Upgrade to a paid Apify plan for unlimited rows.

A box-office or awards field is empty

• Not every title has box-office or awards data (e.g. unreleased or small titles). The row is still returned; those fields are simply omitted.

---

⚠️ Trademark Disclaimer

This is an independent tool and is not affiliated with, endorsed by, or sponsored by IMDb.com, Inc. or Amazon.com, Inc. "IMDb" and related marks are trademarks of their respective owners. This actor accesses publicly available information for legitimate data-analysis purposes under nominative fair use. Users are responsible for ensuring their use complies with applicable laws and the target platform's terms of service.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's Issues tab
• Check the SIÁN Agency Store for more automation tools
• ✉️ apify@sian-agency.online

---

Built by SIÁN Agency | More Tools