Letterboxd

List Letterboxd member reviews

List the first 12 reviews of a Letterboxd member, with rating, likes, spoiler flag and text.

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

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 reviews. One call returns these only. The text is truncated when the review is longer; call the review route for the full text.

datareviews[]id
integernullable

Viewing id.

Who wrote the review; null when the card does not name them.

datareviews[]authorusername
string

Username in lowercase form.

datareviews[]authordisplayName
stringnullable

Display name.

datareviews[]rating
numbernullable

The author's rating, or null.

datareviews[]likes
integernullable

Likes on the review.

datareviews[]commentCount
integernullable

Comments on the review; 0 when the card shows a like control but no comment link, null when the card shows neither.

datareviews[]containsSpoilers
boolean

Whether the review is marked as containing spoilers.

datareviews[]text
stringnullable

The review text.

datareviews[]textTruncated
boolean

Whether the review text is only the opening part.

datareviews[]watchedDate
stringnullable

The viewing date (`Watched`), ISO 8601 date, when shown.

The reviewed film; null on cards that do not repeat it.

datareviews[]filmslug
string

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

datareviews[]filmid
integernullable

Numeric film id.

datareviews[]filmshortCode
stringnullable

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

datareviews[]filmshortUrl
stringnullable

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

datareviews[]filmtitle
stringnullable

Title.

datareviews[]filmyear
integernullable

Release year, when shown.

Tags on the review.

datareviews[]tags[]
stringoptional
datareviews[]rewatch
booleannullable

Whether this was a rewatch; null when the card does not say.

datareviews[]url
stringnullable

Link to the review.

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

Responses

Reviews.