Letterboxd Builders

You can find items using the lists on Letterboxd.com (Letterboxd).

No configuration is required for these builders.

Attribute

Description

Works with Movies

Works with Shows

Works with Playlists and Custom Sort

letterboxd_list

Finds every movie in the Letterboxd List

letterboxd_list_details

Finds every movie in the Letterboxd List and updates the collection with the description of the Letterboxd list

Letterboxd List

Finds every movie in the Letterboxd List or Letterboxd Films Search.

The expected input is a Letterboxd List URL or Letterboxd Film Search URL. Multiple values are supported as either a list or a comma-separated string.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

Using the limit filter attribute is recommended when using a Letterboxd Film Search as the number of results returned could be very large.

collections:
  Vulture’s 101 Best Movie Endings:
    letterboxd_list: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
    collection_order: custom
    sync_mode: sync
  • You can update the collection details with the Letterboxd List’s description by using letterboxd_list_details.

  • You can specify multiple collections in letterboxd_list_details but it will only use the first one to update the collection summary.

collections:
  Vulture’s 101 Best Movie Endings:
    letterboxd_list_details: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
    collection_order: custom
    sync_mode: sync

You can add different filters directly to this builder.

Filter Attribute

Description

limit

Description: Max number of items per returned.
Values: number greater than 1

rating1

Description: Search for the specified rating range. The rating is the list owner’s rating not sitewide rating.
Values: range of int i.e. 80-100

year1

Description: Search for the specified year range.
Values: range of int i.e. 1990-1999

note1

Description: Search for the specified value in the note. The note is the list owner’s note not sitewide note.
Values: Any String

1 These filters only work if the URL is to the List View of the Letterboxd list. (i.e. it should have /detail/ in the url)

collections:
  Vulture’s 101 Best Movie Endings From the 90s:
    letterboxd_list_details: 
      url: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
      year: 1990-1999
    collection_order: custom
    sync_mode: sync