imdbio 0.0.2

A Python service for querying IMDb data

imdbio

Your personal gateway to IMDb data — no API keys required.

Features

• Search movies, series, and people by name or title
• Detailed movie info: cast, crew, ratings, box office, company credits
• TV series support with seasons and episodes
• Person details with biography, filmography and images
• Localized results in multiple languages (global or per-request)
• User reviews, trivia, parental guide, awards info
• Typed Pydantic models
• Built-in caching

Installation

pip install imdbio

Quick Start

from imdbio import search_title, get_movie, get_name

# Search for a title
results = search_title("The Matrix")
for movie in results.titles:
    print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")

# Get movie details
movie = get_movie("0133093")
print(movie.title, movie.year, movie.rating, movie.kind)

# Get person details
person = get_name("nm0000206")
print(person.name, person.birth_date)

# Series example
from imdbio import get_season_episodes
episodes = get_season_episodes("tt1520211", season=1)  # Walking Dead
for ep in episodes[:3]:
    print(ep.title, ep.rating)

📝 More examples in the examples folder.

Why choose imdbio?

• Clean structured data via Pydantic models
• No API keys or external dependencies
• Powered by niquests and lxml
• Ideal for scripts and data analysis

Disclaimer

Not affiliated with IMDb Inc. See DISCLAIMER.

License

MIT — see LICENSE.