IMDb API

Our IMDb API gives you programmatic access to IMDb data that isn't available through any official API. Get data on movie titles, TV shows, ratings, cast information, release years, genres, and more. And the best part? You can try the IMDb API entirely for free, no credit card required.

Try IMDb API

Trusted by industry leaders all over the world

Integrate our IMDb API

Access the IMDb API using Python, JavaScript, CLI, cURL, OpenAPI, or MCP. Choose your preferred option and start extracting IMDb data in minutes.

Python

JavaScript

HTTP

MCP

1from apify_client import ApifyClient
2
3# Initialize the ApifyClient with your Apify API token
4# Replace '<YOUR_API_TOKEN>' with your token.
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7# Prepare the Actor input
8run_input = {
9    "startUrls": [{ "url": "https://www.imdb.com/find/?q=game&ref_=nv_sr_sm" }],
10    "maxItems": 50,
11    "proxyConfiguration": { "useApifyProxy": True },
12    "extendOutputFunction": "($) => { return {} }",
13}
14
15# Run the Actor and wait for it to finish
16run = client.actor("dtrungtin/imdb-scraper").call(run_input=run_input)
17
18# Fetch and print Actor results from the run's dataset (if there are any)
19print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
20for item in client.dataset(run["defaultDatasetId"]).iterate_items():
21    print(item)
22
23# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

IMDb API in Python

IMDb API in JavaScript

IMDb MCP server

IMDb API in CLI

Get data with IMDb API

Extract IMDb data by providing start URLs for movies, TV shows, or search queries. The IMDb Scraper API returns structured JSON data with titles, ratings, cast members, directors, genres, release years, descriptions, and IMDb URLs.

Input

{
 "maxItems": 50,
 "startUrls": [
  {
   "url": "<https://www.imdb.com/find/?q=game&ref_=nv_sr_sm>"
  }
 ],
 "proxyConfiguration": {
  "useApifyProxy": true
 },
 "extendOutputFunction": "($) => { return {} }"
}

Output

{
 "url": "<https://www.imdb.com/title/tt0834174>",
 "year": "1981",
 "genre": "Musical",
 "stars": "Montserrat Caballé, Rémy Corazza, Fernand Dumont",
 "title": "Turandot (1981)",
 "rating": "",
 "country": "France",
 "runtime": "",
 "director": "Pierre Desfons",
 "certificate": "",
 "description": "",
 "ratingcount": "",
 "original title": ""
}

How to use IMDb API

Sign up for Apify account01

Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.

Get started for free

Get your Apify API token02

Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.

Integrate IMDb API03

Navigate to the IMDb API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more.

Open IMDb API

Get your IMDb data via API04

Now, you can use the API and get the data you need from IMDb.

Why use Apify?

Never get blocked

Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.

Customers love us

We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.

Monitor your runs

With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.

Export to various formats

Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.

Integrate Apify to your workflow

You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.

Large developer community

Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!

Get AI-ready IMDb data via API

Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.

Frequently asked questions

No, there is no official IMDb API available to the general public. While IMDb offers some datasets for download and has a developer page, they don't provide a comprehensive public API. This IMDb Scraper creates an unofficial IMDb API alternative by extracting data directly from IMDb.com, giving you access to live movie and TV show data in a structured format.

Yes, you can try the IMDb API for free! The scraper comes with Apify's free tier that includes $5 of platform credits monthly. Based on our testing, you can extract approximately 1,000 movie results for just $0.30, so the free credits allow you to test the scraper extensively before committing to a paid plan.

You can extract comprehensive movie and TV show data including titles, original titles, release years, runtime, certificates, ratings, rating counts, descriptions, cast members (stars), directors, genres, countries, and direct IMDb URLs. The scraper also supports custom data extraction through the extend output function, allowing you to add additional fields like storylines or modify existing data fields.

Web scraping IMDb data is generally legal for non-commercial research, personal use, and publicly available information. However, you should always comply with IMDb's terms of service and applicable laws in your jurisdiction. For commercial use or large-scale data extraction, consider reviewing IMDb's official datasets or contacting them directly for licensing agreements.

Getting started is simple: 1) Click "Try for free" to access the scraper, 2) Configure your start URLs (you can use search pages, top-level categories, or specific movie URLs like https://www.imdb.com/title/tt7286456), 3) Set your maximum items limit, 4) Configure proxy settings if needed, and 5) Run the scraper. The results will be delivered as structured JSON data that you can export or integrate into your applications.