Letterboxd

List Letterboxd member diary

List the first 50 diary entries of a Letterboxd member, with dates, ratings, likes and rewatch flags.

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

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.

datatotalEntries
integernullable

Diary entries in total.

The 50 most recent diary entries. One call returns these only.

dataentries[]viewingId
integernullable

Viewing id.

The film.

dataentries[]filmslug
string

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

dataentries[]filmid
integernullable

Numeric film id.

dataentries[]filmshortCode
stringnullable

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

dataentries[]filmshortUrl
stringnullable

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

dataentries[]filmtitle
stringnullable

Title.

dataentries[]filmyear
integernullable

Release year, when shown.

dataentries[]watchedDate
stringnullable

When it was watched, ISO 8601 date.

dataentries[]rating
numbernullable

The member's rating.

dataentries[]liked
boolean

Whether the member liked it.

dataentries[]rewatch
boolean

Whether this was a rewatch.

dataentries[]hasReview
boolean

Whether the entry has a review.

dataentries[]entry
integernullable

The viewing's entry number from its URL (`/film/{slug}/{entry}/`); null for the first viewing.

dataentries[]entryUrl
stringnullable

The viewing's own URL, which carries the entry number.

dataentries[]reviewUrl
stringnullable

Link to the review, when it has one.

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

Responses

Diary.