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']:

# show all information that are currently available for a movie

# show all information sets that can be fetched for a movie

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


How to contribute

Do you like this project? You can help by:


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.


All news...