IMDb Unofficial API

Unofficial Python SDK for IMDb's internal GraphQL API. 56 typed endpoints for titles, names, credits, charts, reviews and media. No API key required.

What it does:

• Sync client (ImdbClient) and async client (AsyncImdbClient)
• Typed dataclass responses with full type hints
• 55 CLI subcommands
• Cursor pagination on search
• Batch fetches (get_titles, get_names) in one request
• Retries with exponential backoff
• Optional in-memory cache
• Custom exception hierarchy
• One dependency: httpx

Install

pip install imdb-unofficial-api

Quick Start

from imdb_unofficial_api import ImdbClient

with ImdbClient() as c:
    t = c.get_title("tt1375666")
    print(f"{t.title} ({t.release_year}) — {t.rating.aggregate_rating}")

Async:

import asyncio
from imdb_unofficial_api import AsyncImdbClient

async def main():
    async with AsyncImdbClient() as c:
        t = await c.get_title("tt1375666")
        print(t.title)

asyncio.run(main())

CLI:

imdb get tt1375666
imdb search "Inception" --first 10
imdb top-rated-movies --first 10
imdb person nm0000138

Documentation

Contact

For reverse engineering work: t.me/etrnkz