This package implements a Python interface to IMDb plain text data files.

At this time, the API should not be considered stable.

Note that IMDb uses iso-8859-1 encoding (in data files and URLs); this package uses Unicode in most places.

python-imdb supports the following data files (to greater or lesser degree)

• movies
• aka-titles
• ratings
• plot
• genres
• running-times
• color-info
• certificates
• directors
• writers
• actors
• actresses

Download these files into /some/directory and then run python imdb --rebuild-db /some/directory to convert the data files (necessary to support seeking within the data files) and build a search index. This will result in files imdb.zip and imdb.zip.idx.

For search, movies.list is required and aka-titles.list and ratings.list are strongly recommended. However, each file is optional, with associated data and/or features simply being unavailable.

The module includes examples of a simple program (example.py) and a WSGI-based JSON API endpoint (wsgi.py).