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

Disclaimer

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

Cinemagoer 2023.05.01

A small release containing just few fixes to the parsers.

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

All news...