Skip to main content

Python 3 wrapper for the Letterboxd API

Project description

.. Semaphore Build Status .. image:: :target:

.. Travis CI build status .. image:: :target:

.. ReadTheDocs document status .. image:: :target:


Python 3 implementation of the Letterboxd API v0 <>_.

Python ≥3.6 is required.

.. warning::


- It may be broken.
- What is working now may break between now and v1.0
- Initial focus is on implementing endpoints related to retrieving watchlists and other lists for users.

Letterboxd API Access

Letterboxd has posted an example Ruby client <>_, but as they say in the readme there:

Although the Letterboxd API isn’t public yet (as at 2017-06-12), we have seeded some developers with API keys.

If you need more information about API access, please see <>_.


All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog <>_ and this project adheres to Semantic Versioning <>_.



Added .....

  • This CHANGELOG.rst
  • Converted to .rst
  • Documentation written with reStructuredText and Sphinx, being built to Read the Docs <>_
  • Added a number of defaults and tests as provided in cookiecutter-pypackage <>_
  • Added an easy initializer with import letterboxd and then
  • User.refresh_token() to refresh the user authentication oAuth token
  • Coverage for Letterboxd API endpoints:
    • /film/{id}/members
    • /film/{id}/report
    • /film/{id}/statistics
    • /films
    • /films/film-services
    • /films/genres
    • /film-collection/{id}
    • /search

Changed .......

  • All api-calling methods now return the dictionary from the response JSON, instead of the entire requests.Response.

[0.1.0] - 2018-06-24

Added .....

  • First public version! Version 0.1.0a tagged on GitHub <>, and posted to PyPI <>.
  • letterboxd, api, user, auth, member, and film modules.
  • coverage for Letterboxd API endpoints:
    • film
    • /film/{id}
    • /film/{id}/availability — this data is first-party only
    • /film/{id}/me
    • /me
    • /member/{id}/watchlist

Changelog format

  • Each version should:
    • List its release date in ISO 8601 format (YYYY-MM-DD).
    • Group changes to describe their impact on the project, as follows:
      • Added for new features.
      • Changed for changes in existing functionality.
      • Deprecated for once-stable features removed in upcoming releases.
      • Removed for deprecated features removed in this release.
      • Fixed for any bug fixes.
      • Security to invite users to upgrade in case of vulnerabilities.
    • Take a look at this checklist for packaging a new version <>, and this one <>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

letterboxd-0.2.4.tar.gz (27.4 kB view hashes)

Uploaded Source

Built Distribution

letterboxd-0.2.4-py2.py3-none-any.whl (14.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page