Skip to main content

IMDb Unofficial API

CI Python versions License: MIT

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

Features: sync + async clients · full type hints · 55 CLI subcommands · cursor pagination · batch fetching · retry with backoff · optional caching · custom exceptions · no external dependencies beyond 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

File Content
docs/endpoints.md All 56 endpoint methods with descriptions, signatures, return types
docs/cli.md All 55 CLI subcommands and flags
docs/development.md Configuration, exception handling, pagination, architecture

for any reverse enginering work

contact me t.me/etrnkz

Metadata

Release files for imdb-unofficial-api 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for imdb-unofficial-api 0.2.0
File Size Uploaded Provenance Actions
imdb_unofficial_api-0.2.0.tar.gz 32.5 kB Without provenance Details for imdb_unofficial_api-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for imdb-unofficial-api 0.2.0
File Interpreter ABI Platform Actions
imdb_unofficial_api-0.2.0-py3-none-any.whl Python 3 none any Details for imdb_unofficial_api-0.2.0-py3-none-any.whl

Total release size: 65.5 kB

Release files / imdb_unofficial_api-0.2.0.tar.gz

Download URL imdb_unofficial_api-0.2.0.tar.gz
Size 32.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d265e4bd7e0dc9fc478a349333058d14626ab6ef8f0b6bacf7d3e6e50f4da06d
BLAKE2b-256 checksum
How to use checksums
38c58d9fc6b62a47c067728e96696de89f857e1d12842bc8d34e0e1fb27bcdff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / imdb_unofficial_api-0.2.0-py3-none-any.whl

Download URL imdb_unofficial_api-0.2.0-py3-none-any.whl
Size 33.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c3e63102d92cc34dc3f02e39bf9215e62f00a0c6f60247570e757f13c3386f89
BLAKE2b-256 checksum
How to use checksums
6c1c25333976d809b8c65100228f84cd7e8d29b1a8ad617d900f0894b1f93db8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for imdb-unofficial-api 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page