Fork me on GitHub

IMDbPY is a Python package for retrieving and managing the data of the IMDb movie database about movies and people.

Downloads Read the Docs

  • Platform-independent: written in pure Python 3, with a simple API.
  • Can retrieve data from both the IMDb's web server and a local copy of the whole database.
  • Released under the terms of the GPL 2 license or later.
  • IMDbPY is used by many other projects. Curious about that?

Code example


from imdb import IMDb

# create an instance of the IMDb class
ia = IMDb()

# get a movie and print its director(s)
the_matrix = ia.get_movie('0133093')
for director in the_matrix['directors']:
    print(director['name'])

# show all information that are currently available for a movie
print(sorted(the_matrix.keys()))

# show all information sets that can be fetched for a movie
print(ia.get_movie_infoset())

# update a Movie object with more information
ia.update(the_matrix, ['technical'])
# show which keys were added by the information set
print(the_matrix.infoset2keys['technical'])
# print one of the new keys
print(the_matrix.get('tech'))

  

How to contribute

Do you like this project? You can help by:

News

IMDbPY 6.8 released

In the release 6.8 (codename "Apollo 11") of IMDbPY, multiple parsers were added and fixed; the new search_movie_advanced method allows advanced movie searches. As always, IMDbPY is looking for developers; if you want to contribute, contact us.

Changelog

All news...