Python IMDB client using the IMDB json web service made available for their iOS app.
Titlethis can be a movie, tv show, video, documentary etc.Namethis can be a credit, cast member, any person generally.
To install imdbpie, simply:
pip install imdbpiefrom imdbpie import Imdb
imdb = Imdb()NOTE: For each client method, if the resource cannot be found they will raise LookupError, if there is an API error then ImdbAPIError will raise.
imdb.get_title('tt0111161')
# Returns a dict containing title informationimdb.get_title_genres('tt0303461')
# Returns a dict containing title genres informationimdb.get_title_credits('tt0303461')
# Returns a dict containing title credits informationimdb.get_title_quotes('tt0303461')
# Returns a dict containing title quotes informationimdb.get_title_ratings('tt0303461')
# Returns a dict containing title ratings informationimdb.get_title_connections('tt0303461')
# Returns a dict containing title connections informationimdb.get_title_similarities('tt0303461')
# Returns a dict containing title similarities informationimdb.get_title_videos('tt0303461')
# Returns a dict containing title videos informationimdb.get_title_episodes('tt0303461')
# Returns a dict containing season and episodes informationimdb.get_title_plot('tt0111161')
# Returns a dict containing title plot informationimdb.get_title_plot_synopsis('tt0111161')
# Returns a dict containing title plot synopsis informationimdb.get_title_awards('tt0111161')
# Returns a dict containing title awards informationimdb.get_title_releases('tt0111161')
# Returns a dict containing releases informationimdb.get_title_versions('tt0111161')
# Returns a dict containing versions information (meaning different versions of this title for different regions, or different versions for DVD vs Cinema)imdb.get_title_user_reviews('tt0111161')
# Returns a dict containing user review informationimdb.get_title_metacritic_reviews('tt0111161')
# Returns a dict containing metacritic review informationimdb.get_title_images('tt0111161')
# Returns a dict containing title images informationimdb.title_exists('tt0111161')
# Returns True if exists otherwise Falseimdb.search_for_title("The Dark Knight")
# Returns list of dict results
[{'title': "The Dark Knight", 'year': "2008", 'imdb_id': "tt0468569"},{'title' : "Batman Unmasked", ...}]imdb.search_for_name("Christian Bale")
# Returns list of dict results
[{'imdb_id': 'nm0000288', 'name': 'Christian Bale'},{'imdb_id': 'nm7635250', ...}]imdb.get_name('nm0000151')
# Returns a dict containing person/name informationimdb.get_name_filmography('nm0000151')
# Returns a dict containing person/name filmography informationimdb.get_name_images('nm0000032')
# Returns a dict containing person/name images informationimdb.get_name_videos('nm0000032')
# Returns a dict containing person/name videos informationimdb.validate_imdb_id('tt0111161')
# Raises `ValueError` if not validimdb.get_popular_titles()
# Returns a dict containing popular titles informationimdb.get_popular_shows()
# Returns a dict containing popular titles informationimdb.get_popular_movies()
# Returns a dict containing popular titles information1. Python 2 or 3
2. See requirements.txt
pip install -r test_requirements.txt
py.test src/tests