Get Letterboxd member statistics
Get a Letterboxd member's statistics, or the partial header when they are restricted.
Headers
Get your API keyAPI key (`sfk_...`)
Letterboxd username: letters, digits and `_`, e.g. `davidehrlich`. Input is lowercased. Required, no default; at most 64 characters.
min 1 chars · max 64 chars
Endpoint-specific response payload.
`restricted` when the member's statistics are not public; `not_found` when the username does not exist.
one of: found, restricted, not_found
The member's public header. On `restricted`, only `username` is filled and `displayName`, `avatar` and `badge` are null. On `found`, `badge` is null because the statistics response does not include it.
Username in lowercase form.
Display name.
Avatar URL. Link only; the image is not hosted by Social Fetch.
Membership badge shown beside the name (e.g. `Patron`), or null when it is not included. The statistics route does not carry it.
The all-time statistics; null when restricted or not found.
Films watched.
Hours watched.
Directors watched.
Countries watched.
Longest viewing streak, when shown.
The streak as text, e.g. `9w`.
The streak tooltip, when available.
Days with two or more films.
Every statistic block, in order.
Statistic label.
The statistic value.
Progress through the featured lists.
List name.
Films on the list.
Link to the list.
The member's statistics URL, or null when not found.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/letterboxd/users/davidehrlich/stats" \
-H "x-api-key: YOUR_API_KEY"Responses
Statistics.