Metadata-Version: 2.4
Name: imdbio
Version: 0.0.2
Summary: A Python service for querying IMDb data
Project-URL: Homepage, https://rjriajul.github.io/imdbio/
Project-URL: Source, https://github.com/rjriajul/imdbio
Project-URL: Issues, https://github.com/rjriajul/imdbio/issues
Author: rjriajul
License-Expression: MIT
License-File: LICENSE
Keywords: api,data,film,imdb,information,metadata,movie,python,scraper,tv
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: cryptography
Requires-Dist: curl-cffi
Requires-Dist: deprecated
Requires-Dist: jmespath
Requires-Dist: lxml
Requires-Dist: niquests
Requires-Dist: pydantic
Provides-Extra: dev
Requires-Dist: poethepoet>=0.32; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: twine>=5; extra == 'dev'
Description-Content-Type: text/markdown

[![PyPI Downloads](https://static.pepy.tech/badge/imdbio)](https://pepy.tech/projects/imdbio)
[![PyPI Version](https://img.shields.io/pypi/v/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)
[![Python Versions](https://img.shields.io/pypi/pyversions/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)

# 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

```bash
pip install imdbio
```

## Quick Start

```python
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](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](DISCLAIMER.txt).

## License

MIT — see [LICENSE](LICENSE).
