Social Fetch
Start for freeStart free
Letterboxd hub

Letterboxd Member API

A member's public header and total films watched. No bio, location, website, favourites, follower count or following count.

GET /v1/letterboxd/users/{username}

1 credit Failed requests are free A not-found answer is still charged

Try in playgroundFull API docs

About this endpoint

GET /v1/letterboxd/users/{username} returns data.user with username, displayName, avatar and badge, plus totalFilms, the member's films-watched count. The route does not return the bio, location, website, favourites, follower count or following count. Those fields are absent rather than returned as invented nulls.

Use this route when you only need to resolve a username to a display name and a film count. For activity, use the watched films, diary, reviews, watchlist, lists, followers, following, activity or tags routes. The same header object appears on each of those routes, so a joined flow does not need a second call.

Letterboxd Member API FAQ

Why are bio, location and follower count missing?

The member route returns the public header and totalFilms only. It does not return the bio, location, website, favourites, follower count or following count. Follower and following counts do appear on the follower and following rows of other members.

Which fields are always present on data.user?

username is always a string. displayName, avatar and badge are nullable, because a member may have no display name, no custom avatar or no badge. totalFilms is nullable when no count is available.

Is this the route for a member's films?

No. It returns the header and the count. GET /v1/letterboxd/users/{username}/films returns the first 72 watched film rows with ratings and likes.

How many credits does a member lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

What does lookupStatus mean here?

found means data.user is the member header. not_found means the username does not exist or was deleted, and data.user is null.

Other Letterboxd endpoints