Letterboxd

List Letterboxd member watched films

List the first 72 films a Letterboxd member has watched, with their rating and like.

GET/v1/letterboxd/users/{username}/films
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
22

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.

datatotalFilms
integernullable

Films watched.

The first 72 films the member has watched, most recently watched first. One call returns these only.

The film.

datafilms[]filmslug
string

Film slug, e.g. `parasite-2019`.

datafilms[]filmid
integernullable

Numeric film id.

datafilms[]filmshortCode
stringnullable

Short code used by `https://boxd.it/{shortCode}`.

datafilms[]filmshortUrl
stringnullable

Derived short link; null when the short code was not shown.

datafilms[]filmtitle
stringnullable

Title.

datafilms[]filmyear
integernullable

Release year, when shown.

datafilms[]rating
numbernullable

The member's rating, or null.

datafilms[]liked
boolean

Whether the member liked it.

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/films" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Watched films.