Letterboxd hub

Letterboxd Reviews API

A member's review cards with rating, likes, spoiler flag, watched date and tags.

GET /v1/letterboxd/users/{username}/reviews

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

About this endpoint

GET /v1/letterboxd/users/{username}/reviews returns data.user, and data.reviews. Each review card has id, author, rating, likes, commentCount, containsSpoilers, text, textTruncated, watchedDate, film, tags, rewatch and url.

The text is truncated when the review is longer, so textTruncated is true. Use the single review route when you need the full text, the rewatch number or the author badge. commentCount is 0 when the card shows a like control but no comment link. One call returns the first 12 cards; there is no page or cursor parameter and no next page.

Letterboxd Reviews API FAQ

Is the review text complete on this route?

Not always. When the review text is truncated, textTruncated is true. The single review route returns the complete text, so use it when the body matters.

What do likes and commentCount mean?

likes is the number of likes on the review and commentCount is the number of comments shown on the card; commentCount is 0 when the card shows a like control but no comment link. Comment bodies themselves are not exposed by this API.

How do I tell a rewatch review?

review.rewatch is true when the card is marked as a rewatch. The rewatch number comes from the review URL and is returned as entry by the single review route.

How many reviews does one call return?

12. The route takes no page or cursor.

How many credits does a reviews 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.