https://semaphoreci.com/api/v1/bobtiki/letterboxd/branches/master/badge.svg https://travis-ci.org/bobtiki/letterboxd.svg?branch=master https://readthedocs.org/projects/letterboxd/badge/?version=latest

Letterboxd

Python 3 implementation of the Letterboxd API v0.

Python ≥3.6 is required.

Warning

THIS PROJECT IS CURRENTLY IN ALPHA:

  • 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 https://letterboxd.com/api-coming-soon/.

Acknowledgements

Thanks to Kevin Ndung’u Gathuku of Semaphore for this article on writing and testing an API wrapper from which I learned many of the techniques I used to build this wrapper.

And of course, many thanks to Matthew Buchanan and Grant Berridge at Letterboxd for allowing me beta access to the Letterboxd API, and providing helpful assistance when I stumbled.