List Letterboxd member watchlist
List the first 28 films on a Letterboxd member's public watchlist; a private one answers `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 watchlist is private.
one of: found, not_found, restricted
The member's public header; on `restricted`, only the requested `username` is filled.
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.
Films the member wants to see.
The first 28 films on the watchlist. One call returns these only.
Film slug, e.g. `parasite-2019`.
Numeric film id.
Short code used by `https://boxd.it/{shortCode}`.
Derived short link; null when the short code was not shown.
Title.
Release year, when shown.
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/dave/watchlist" \
-H "x-api-key: YOUR_API_KEY"Responses
Watchlist.