Letterboxd

Get Letterboxd member

Try in Playground

Get a Letterboxd member's public header and the number of films they have watched.

Try in Playground

GET/v1/letterboxd/users/{username}

Headers

Get your API key

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

12

Endpoint-specific response payload.

datalookupStatus

string

`not_found` when the member does not exist or was deleted.

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. This route does not return the bio, location, website, favourites or the member's own follower count.

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

Responses

Member.

Filmography

List the films in a Letterboxd person or studio filmography; a studio returns its first 24.

Watched films

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