Skip to main content

A Python service for querying IMDb data

Project description

Build Status PyPI Version Python Versions PyPI Downloads

imdbinfo

Your personal gateway to IMDb data. Search for movies and people and get structured information in seconds.

Features

  • 🔍 Search movies and people by name or title
  • 🎬 Detailed movie info including cast, crew, ratings and more
  • 👥 Detailed person info with biography, filmography and images
  • 📝 Typed Pydantic models for predictable responses
  • No API keys required

Installation

pip install imdbinfo

Quick Start

from imdbinfo.services 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") # or 'tt0133093'
print(movie.title, movie.year, movie.rating)

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

For more examples see the examples folder.

Why choose imdbinfo?

  • Easy to use Python API
  • Returns clean structured data
  • Powered by requests and lxml
  • Uses Pydantic for type safety
  • No external dependencies or API keys required
  • Ideal for quick scripts and data analysis

License

imdbinfo is released under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Open an issue or pull request on GitHub.

If you find this project useful, please consider giving it a ⭐ on GitHub!

Please read our Contributing Guidelines and Code of Conduct before contributing.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imdbinfo-0.3.5.tar.gz (476.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imdbinfo-0.3.5-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file imdbinfo-0.3.5.tar.gz.

File metadata

  • Download URL: imdbinfo-0.3.5.tar.gz
  • Upload date:
  • Size: 476.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.17

File hashes

Hashes for imdbinfo-0.3.5.tar.gz
Algorithm Hash digest
SHA256 960777a9668c83b8302aa6f1792fa8c7e8509a437f7d6950699f8cfc14e91be6
MD5 96cb89bfbed1f1f6a30c83ad4520d101
BLAKE2b-256 72a2f4c94a76cbf4e9592baf5378efb45a58eef5c58f8bfe4a32724e7c9ac3a7

See more details on using hashes here.

File details

Details for the file imdbinfo-0.3.5-py3-none-any.whl.

File metadata

  • Download URL: imdbinfo-0.3.5-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.17

File hashes

Hashes for imdbinfo-0.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 650d6fd52bf6e0992ea21024110632fedf4ada7f8e4d957ad99619abcf8ce7f8
MD5 93fb8d1dfc04b3ffdfede0248177f01b
BLAKE2b-256 36655733ab8e1c568b3081ad1f15ed99aff417473260f1adfbad8b134a94e2de

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page