Letterboxd

List Letterboxd member lists

List the first 12 public lists of a Letterboxd member, with film counts, likes and poster slugs.

GET/v1/letterboxd/users/{username}/lists
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
usernamestringrequiredpath

Letterboxd username: letters, digits and `_`, e.g. `davidehrlich`. Input is lowercased. Required, no default; at most 64 characters.

min 1 chars · max 64 chars

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the member does not exist.

one of: found, not_found

The member's public header; null when not found.

datauserusername
string

Username in lowercase form.

datauserdisplayName
stringnullable

Display name.

datauseravatar
stringnullable

Avatar URL. Link only; the image is not hosted by Social Fetch.

datauserbadge
stringnullable

Membership badge shown beside the name (e.g. `Patron`), or null when it is not included. The statistics route does not carry it.

The first 12 lists. One call returns these only.

datalists[]id
integernullable

List id.

datalists[]owner
stringnullable

Owner username in lowercase.

datalists[]slug
string

List slug.

datalists[]title
string

List title.

datalists[]url
string

Link to the list.

datalists[]filmCount
integernullable

Number of films in the list, when available.

datalists[]likes
integernullable

Likes on the list.

datalists[]comments
integernullable

Comments on the list.

datalists[]note
stringnullable

The list owner's note.

Film slugs of the list's preview posters.

datalists[]posterSlugs[]
stringoptional

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/letterboxd/users/davidehrlich/lists" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lists.