Skip to main content

A Letterboxd-compatible FilmAffinity scrapper.

Project description

filmAffinity to Letterboxd

(Versión en español)

Generates CSV file compatible with Letterboxd diary importer from FilmAffinity user's data given their ID.

This program is intended for personal use only; please ensure the person you are getting the data from consents to it beforehand and check which privacy and data protection regulations might apply before using the program to get data from other people.


Using pip

You can install fa-scrapper using pip (Python 3.5+):

pip install fa-scrapper

Then run

fa-scrapper [--csv FILE] [--lang LANG] id

Using Docker

You need to install Docker. Once installed, run:

docker build -t fa-image
docker run --name fa-container fa-image fa-scrapper id
docker cp fa-container:/*.csv .
docker rm fa-container`

Getting your IDs

In order to get your FilmAffinity data you need to find out what your FilmAffinity ID is. There are different IDs for your user ratings and your lists.

How to get your user id

Go to your profile page and copy the user_id field from the URL:

How to get a list id

Go to the list pages (in the left menu), and access the list you want (it needs to be public).

You need to copy the list_id field from the URL:


  • --list LIST sets ID of the public list you want to export
  • --csv FILE sets CSV export file name to FILE
  • --lang LANG sets language to LANG. Letterboxd importer works best in English, the default option.


  • Could not set locale: The script attempts to guess your locale setting given your platform. If it fails to do so you need to provide it yourself. On Linux you can get available locales by running locale -a in your terminal.

Project details

Download files

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

Files for fa-scrapper, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size fa_scrapper-0.1.1-py3-none-any.whl (17.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fa-scrapper-0.1.1.tar.gz (17.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page