Letterboxd

Get Letterboxd review

Get a Letterboxd review with its full text, rating, watched date, tags, likes and rewatch number.

GET/v1/letterboxd/users/{username}/films/{slug}/review
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
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

slugstringrequiredpath

Letterboxd film slug: letters, digits and hyphens, e.g. `parasite-2019`. Input is lowercased. Required, no default; 1 to 200 characters.

min 1 chars · max 200 chars

entryintegeroptionalquery

Entry number from the review URL (`/{username}/film/{slug}/{entry}/`). Omit it for the viewing without a number; `rewatch` tells you whether it is a rewatch.

≥ 1 · ≤ 99999

Response fields
29

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the member, film or entry does not exist.

one of: found, not_found

The review when found; otherwise null.

datareviewid
integernullable

Viewing id.

datareviewentry
integernullable

Entry number from the review URL; null when the URL carries no number. `rewatch` tells you whether it is a rewatch.

datareviewrewatch
boolean

Whether this viewing was a rewatch.

Who wrote it.

datareviewauthorusername
string

Username.

datareviewauthordisplayName
stringnullable

Display name.

datareviewauthorbadge
stringnullable

Membership badge.

The reviewed film.

datareviewfilmslug
string

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

datareviewfilmid
integernullable

Numeric film id.

datareviewfilmshortCode
stringnullable

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

datareviewfilmshortUrl
stringnullable

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

datareviewfilmtitle
stringnullable

Title.

datareviewfilmyear
integernullable

Release year, when shown.

datareviewrating
numbernullable

The author's rating, or null.

datareviewwatchedDate
stringnullable

When it was watched, ISO 8601 date.

datareviewtext
stringnullable

The full review text; null when this viewing has no review text.

datareviewcontainsSpoilers
boolean

Whether the review is marked as containing spoilers.

Tags on the review.

datareviewtags[]
stringoptional
datareviewlikes
integernullable

Likes on the review.

datareviewurl
string

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/films/batman-v-superman-dawn-of-justice/review" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Review.