IMDb API Python Client

Extract IMDb data with our IMDb API Python client. Get programmatic access to release years, genres, cast information, ratings, TV shows, movie titles, and more using simple Python code. Start free, no credit card required.

Try IMDb API Python Client

Trusted by industry leaders all over the world

Integrate our IMDb API

The Apify API client for Python is the official library that allows you to use IMDb API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.

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

IMDb API in JavaScript

IMDb MCP server

IMDb API in CLI

Get data with IMDb API Python client

Use our Python API client to extract IMDb data by providing start URLs for movies, TV shows, or search queries. The API returns structured data, including 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

Install Apify Python client02

Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with IMDb API from your Python applications.

Get your Apify API token03

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 API04

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. Use the provided Python code examples to integrate IMDb API into your Python application.

Open IMDb Python API

Get your IMDb data via API05

The IMDb API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.

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!

Python-ready IMDb data extraction

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 Python API client available to the general public. While IMDb offers some datasets for download and has a developer page, they don't provide a comprehensive public Python API client. This IMDb Scraper creates an unofficial IMDb Python API client 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 Python API client for free! The Python client connects to Apify's scraper which 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 using the Python API client, so the free credits allow you to test the Python API client extensively before committing to a paid plan.

You can extract comprehensive movie and TV show data through the Python API client including titles, original titles, release years, runtime, certificates, ratings, rating counts, descriptions, cast members (stars), directors, genres, countries, and direct IMDb URLs. The Python API client 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 with a Python API client 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 using Python clients, consider reviewing IMDb's official datasets or contacting them directly for licensing agreements.

Getting started with our IMDb Python API is easy — simply create a free Apify account, get your API token, and start using the IMDb API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.