Python IMDB client using the IMDB json web service made available for their iOS app.
imdb = Imdb()
imdb = Imdb({'anonymize' : True}) # to proxy requests
imdb.find_by_title("The Dark Knight") => [{'title' : "The Dark Knight", 'year' : "2008", 'imdb_id' : "tt0468569"}, {'title' : "Batman Unmasked", ...}]
movie = imdb.find_movie_by_id("tt0468569")
movie.title => "The Dark Knight"
movie.rating => 8.1
movie.certification => "PG-13"
movie = imdb.find_movie_by_id("tt1210166")
movie.trailer_url => "http://ia.media-imdb.com/images/M/MV5BODM1NDMxMTI3M15BMl5BanBnXkFtZTcwMDAzODY1Ng@@._V1_.jpg"
imdb.top_250() => [{'title': 'The Shawshank Redemption', 'year': '1994', 'type': 'feature', 'rating': 9.3,...}, ...]
imdb.popular_shows() => [{'title' : "Glee", 'year' : "2009", 'imdb_id' => "tt1327801"}, {'title' : "Dexter", ...}]
Returns either True or False
imdb.movie_exists('tt1327801') => True
imdb.validate_id('tt1000') => tt0001000
Returns a list of image objects with the following attributes (caption, url, width, height)
images = imdb.person_images("tt0468569")
Returns a list of image objects with the following attributes (caption, url, width, height)
images = imdb.title_images("tt0468569")
movie = imdb.find_movie_by_id("tt1210166")
for person in movie.credits:
# check if they are a writer
if person.token == 'writers':
print person.name + ' is a writer'
else:
print person.name + ' is not a writer'
1. Python 2.7+
2. Python requests - python-requests.org
Test .py files can be found in /tests, run these to ensure ImdbPie is working 100%.