Get Letterboxd list
Get a Letterboxd list with its description, tags, likes, clones and first 100 films.
Headers
Get your API keyAPI key (`sfk_...`)
Letterboxd username: letters, digits and `_`, e.g. `davidehrlich`. Input is lowercased. Required, no default; at most 64 characters.
min 1 chars · max 64 chars
Letterboxd list slug: letters, digits, `-`, `_`, `.`, `~` or `:`, e.g. `letterboxds-top-500-films`. Required, no default; 1 to 200 characters.
min 1 chars · max 200 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._~:-]*$
Endpoint-specific response payload.
`not_found` when the member or list does not exist.
one of: found, not_found
The list when found; otherwise null.
List slug.
List title.
Who made the list.
Username in lowercase form.
Display name.
When the list was published, ISO 8601.
When the list was last updated, ISO 8601.
The list's description.
Whether the description is only the opening part.
Tags on the list.
The first 100 films of the list, in list order. One call returns these only.
Film slug, e.g. `parasite-2019`.
Numeric film id.
Short code used by `https://boxd.it/{shortCode}`.
Derived short link; null when the short code was not shown.
Title.
Release year, when shown.
Total films in the list, when available.
Likes on the list.
Times the list was cloned.
Visibility, e.g. `public`.
Link to the list.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/letterboxd/users/davidehrlich/lists/christopher-nolan-films-ranked" \
-H "x-api-key: YOUR_API_KEY"Responses
List.