Cinemagoer (previously known as IMDbPY) is a Python package for retrieving and managing the data of the IMDb movie database about movies and people.


This project and its authors are not affiliated in any way to Internet Movie Database Inc.; see the disclaimer file for details about data licenses.

Code example

from imdb import Cinemagoer

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

# 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 renamed to Cinemagoer

New year, new name: after almost 18 years, we decided to change the name of the project: welcome Cinemagoer!

For more details see the latest changelog, including unreleased changes.

All news...