Skip to main content

PyPI Python Versions

Python IMDB client using the IMDB JSON web service made available for their iOS application.

API Terminology

  • Title this can be a movie, tv show, video, documentary etc.

  • Name this can be a credit, cast member, any person generally.

Installation

To install imdbpie, simply:

pip install imdbpie

How to use

Choose an option:

  1. ImdbPie Facade usage examples (the easy way, returns objects).

  2. ImdbPie Client usage examples (more low level client API, returns raw dicts).

Requirements

1. Python 2 or 3
2. See requirements.txt

Running the tests

pip install -r test_requirements.txt
py.test src/tests

Release History

5.7.1 (2026-07-06)

  • Handle IMDb have both 7 and 8 digit titles

5.7.0 (2026-04-05)

  • Added Python 3.14 support

  • Added support for the new AWS library to handle the authentication

  • Removed unsupported methods that got blocked by the Web Application Firewall (WAF) of the API.

  • Updated dependencies to latest

5.6.5 (2023-04-18)

  • Packaging fixes.

5.6.4 (2023-04-18)

  • Fix for JSON parsing from the API.

  • Fix for title_exists method raising 403 error.

5.6.3 (2018-10-13)

  • Bugfix for handing of national characters within search methods.

5.6.2 (2018-07-09)

  • Bugfix for issue in ImdbFacade.get_title where TypeError would raise if the Title did not have any genres.

5.6.1 (2018-06-17)

  • Bugfix for issue in ImdbFacade.get_title where with titles which no do yet have credits information would cause KeyError to raise.

5.6.0 (2018-06-09)

  • Adds runtime attribute to ImdbFacade.

5.5.0 (2018-05-27)

  • Adds get_title_auxiliary method to client.

  • Adds ImdbFacade facade for API.

5.4.5 (2018-04-29)

  • Packaging documentation updates.

5.4.4 (2018-04-17)

  • Python 2.x setup.py bugfix.

  • Bugfix for title_exists method returning None.

  • Bugfix for get_title raising an incorrect exception when redirection title.

5.4.3 (2018-04-05)

  • Updates license.

5.4.2 (2018-04-05)

  • Fixes missing setuptools dependency for pypi display of markdown formatted files.

5.4.1 (2018-04-05)

  • Packaging documentation fixes.

5.4.0 (2018-03-18)

  • Bugfix for incorrect AttributeError message showing when undefined attrs called on client class.

  • Adds get_title_top_crew method.

5.3.0 (2018-02-27)

  • Adds get_title_plot_taglines method.

  • Adds get_title_news method.

  • Adds get_title_trivia method.

  • Adds get_title_soundtracks method.

  • Adds get_title_goofs method.

  • Adds get_title_technical method.

  • Adds get_title_companies method.

  • Adds get_title_episodes_detailed method.

5.2.0 (2018-01-11)

  • Updates get_title to call “/auxiliary” as “/fulldetails” endpoint now returns an error.

  • Adds get_title_quotes method.

  • Adds get_title_ratings method.

  • Adds get_title_connections method.

  • Adds get_title_awards method.

  • Adds get_title_plot_synopsis method.

  • Adds get_title_versions method.

  • Adds get_title_releases method.

  • Adds get_title_similarities method.

  • Adds get_title_videos method.

  • Adds get_name_videos method.

  • Adds get_name_filmography method.

  • Adds response status code to ImdbAPIError exception message.

5.1.0 (2018-01-10)

  • Adds get_title_genres method.

5.0.0 (2018-01-10)

  • Fixes client to work with new API.

  • Renames most of methods on Imdb class.

  • Changes all methods on Imdb to return raw JSON resource dictionary rather than Python objects.

  • Removes params from Imdb __init__ method (user_agent, proxy_uri, verify_ssl, api_key, cache, anonymize).

  • Adds clear_cached_credentials method to Imdb class.

4.4.2 (2018-01-03)

  • Fixes bug when searching with non alphanumeric characters, second attempt.

4.4.1 (2017-12-27)

  • Fixes bug when searching with non alphanumeric characters.

4.4.0 (2017-12-24)

  • Fixes search_for_person and search_for_title methods, which were broken because XML api used by the client was removed, migrated to using search suggestions api used by the website itself.

  • Adds optional session param to client init method, used to specify requests.Session.

  • All client methods will raise ValueError if invalid imdb_id param given.

4.3.0 (2017-08-10)

Added

  • Added Imdb.popular_movies to retrieve current popular movies.

4.2.0 (2016-09-29)

Added

  • Person.photo_url has been added. It returns a string (url) or None.

4.1.0 (2016-07-26)

  • Changed Title and other objects to use less memory.

  • Added notice of deprecation of caching in version 5.0.0.

  • Added Imdb.get_episodes to retrieve Title Episode information.

4.0.2 (2015-08-08)

Added - Added cache_expiry parameter to Imdb class, to specify cache expiry in seconds.

Changes

  • Internal caching changed you use 3rd party package cachecontrol.

Removed

  • Imdb class no longer takes a cache_dir parameter.

3.0.0 (2015-06-12)

Changed

  • All methods on Imdb will raise imdbpie.exceptions.HTTPError if a bad request to the API or resource is not found (“Errors should never pass silently”).

  • Imdb.get_title_reviews now has param max_results to limit number of reviews returned.

2.1.0 (2015-05-03)

Added - Added verify_ssl kwarg option to Imdb object. Allows for controlling of ssl cert verification on all requests made.

2.0.1 (2015-03-30)

Added

  • Title.plot_outline has been added. It returns a string.

2.0.0 (2015-03-12)

Added

  • Imdb.search_for_person has been added. It returns a list of dicts.

  • Imdb.get_title_plots has been added. It returns a list of strings.

  • Title.trailer_image_urls returns a list of trailer urls (string).

  • Imdb.get_person_by_id has been added. It returns a Person object.

Changed

  • Title.plots returns a list of full plots.

  • Title.trailers returns a list of dicts (keys: “url”, “format”).

  • Title.runtime returns runtime in seconds now instead of hours.

  • Person.role is now Person.roles and returns a list rather than a string.

  • Imdb.person_images has been renamed to Imdb.get_person_images.

  • Imdb.title_reviews has been renamed to Imdb.get_title_reviews and parameter limit has also been removed.

  • Imdb.title_images has been renamed to Imdb.get_title_images.

  • Imdb.find_by_title has been renamed to Imdb.search_for_title.

  • Imdb.find_movie_by_id has been renamed to Imdb.get_title_by_id and parameter json has been removed.

  • Imdb.movie_exists has been renamed to Imdb.title_exists.

Removed

  • Imdb.validate_id has been removed.

  • Title.plot_outline has been removed.

  • Title.trailer_img_url has been removed.

1.5.6 (2014-12-07)

  • No notes, release made before changelog inception.

Download files

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

Source Distribution

imdbpie-5.7.1.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

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

imdbpie-5.7.1-py2.py3-none-any.whl (13.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file imdbpie-5.7.1.tar.gz.

File metadata

  • Download URL: imdbpie-5.7.1.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for imdbpie-5.7.1.tar.gz
Algorithm Hash digest
SHA256 b506904d86dfefdf1f870e0739e69205c528979da7ac45e65bed59842c6f7fed
MD5 f41df99d57539de75ee19f07ff4bdc52
BLAKE2b-256 b9fbda27238d40d76e43adeff43606951156fba10ff64db0ac946c5f69f64d20

See more details on using hashes here.

File details

Details for the file imdbpie-5.7.1-py2.py3-none-any.whl.

File metadata

  • Download URL: imdbpie-5.7.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for imdbpie-5.7.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 16fd5ddc42b93023829f3899cde6c89f5a8d00528e7ddef1c4f26fbbf1f3e237
MD5 377a29446930372eb38e481f7b4a1310
BLAKE2b-256 ef9fcafdc9aef97821617ff3b0f9432c843307592a8583e2b6cc075787046fe7

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 Sentry Error logging StatusPage Status page