Created: 2011-07-17 22:58
Updated: 2016-12-27 21:57
License: mit


What is this?

cineworld offers an easy-to-use Python wrapper to interact with the Cineworld API. Before you try and use the API, make sure you sign up to get an API Key.

In order to cut down on boilerplate code, you can then save your API key in the file.

Also, note that this package is in no way associated or endorsed by


fuzzywuzzy at

Provides fuzzy searching capabilities


Download the source and use the python executable:

python install

Or, if you want to help develop the package, just git clone the Github repository:

git clone


Without saving your API key in the file:

>>> from cineworld import CW
>>> CW('my_api_key').film_search('some movie here')

With your API key saved:

>>> from cineworld import CW
>>> CW().film_search('some movie here')

NOTE: Documentation from this point forward will assume you have saved your Cineworld Developer API Key to the file (which you should consider doing in order to cut down on boilerplate code).


  • get_film_list -- Get a list of all current films

    >>> cw = CW()
    >>> cw.get_film_list()
	[{u'edi': 39523, u'title': u'3D - Harry Potter And The Deathly Hallows Pt 2'}, {u'edi': 40501, u'title': u'3D - Transformers: Dark Of The Moon'}, ...]
  • film_search -- Custom implemented search to find a list of films relating to the search term, returns an ordered list with strongest match first.

    >>> cw = CW()
    >>> cw.film_search('harry potter')
    [{'edi': 39523, 'strength': 90, 'title': '3D - Harry Potter And The Deathly Hallows Pt 2'}, {'edi': 35231, 'strength': 90, 'title': '2D - Harry Potter And The Deathly Hallows Pt 2'}]
  • get_film_id -- Get film id, choosing the strongest match generated from the film_search() function, allows you to specify 3D or 2D.

    >>> cw = CW()
    >>> cw.get_film_id('harry potter', True)
	>>> cw.get_film_id('harry potter', False)
  • get_film_info -- Get film info.

    >>> cw = CW()
    >>> cw.get_film_info(39523)
    [{'advisory': 'Contains moderate threat, injury detail and language', 'film_url': '', ...}]


In order to run the tests for, make sure you have the mock library installed.



Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more