Cinemagoer (previously known as IMDbPY) is a Python package for retrieving and managing data from the IMDb non-commercial downloadable datasets.

• Platform-independent: written in pure Python 3, with a simple API.
• Released under the terms of the GPL 2 license or later.
• Cinemagoer is used by many other projects. Curious about that?

Code example

Cinemagoer reads data from a local database populated from IMDb datasets. First, download and import the data:

# Download the *.tsv.gz files from https://datasets.imdbws.com/
download-from-s3

# Import them into a local SQLite database
s32cinemagoer.py /path/to/imdb-tsv-files/ sqlite:///cinemagoer.db
  

Then use Cinemagoer to query the database:

from imdb import Cinemagoer

# open the database populated with s32cinemagoer.py
ia = Cinemagoer('s3', uri='sqlite:///cinemagoer.db')

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

# print the genres of the movie
print(the_matrix['genres'])

# search for a person by name
people = ia.search_person('Keanu Reeves')
for person in people:
    print(person.personID, person['name'])
  

How to contribute

Do you like this project? You can help by:

• Spreading the word!
• Contributing to development.

News

All news...