> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/letterboxd/users-username-lists>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/letterboxd/users-username-lists.mdx>

---

# Letterboxd Member Lists API

A member's public lists with film counts, likes, comments, a note and the poster slugs on each card.

`GET /v1/letterboxd/users/{username}/lists` returns `data.user`, and `data.lists`. Each list summary has `id`, `owner`, `slug`, `title`, `url`, `filmCount`, `likes`, `comments`, `note` and `posterSlugs`. `posterSlugs` names up to ten films whose posters are included on the list card, which is enough to build a preview without fetching every list.

One call returns the first 12 lists; there is no `page` or `cursor` parameter and no next page. The summary is for browsing; call `GET /v1/letterboxd/users/{username}/lists/{slug}` when you need the list description, tags and the film rows. Counts are nullable when not available. The owner's note is the short note on the card, not the full description.

## Request

- **Endpoint:** `GET /v1/letterboxd/users/{username}/lists`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by username
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/letterboxd/users/username/lists/get)
- **Platform page:** [/platforms/letterboxd](https://www.socialfetch.dev/platforms/letterboxd)

## FAQ

### What is the difference between this route and the list route?

This route lists a member's lists with summary fields such as filmCount, likes, comments and posterSlugs. The single list route returns the description, tags, films and visibility for one list.

### Why are likes or comments null?

Those counters are nullable because they are not always available. A null means the number was not on the card, not that it is zero.

### How do I go from a summary to the list's films?

Use owner and slug from the summary. GET /v1/letterboxd/users/{owner}/lists/{slug} returns the list with its first 100 films.

### How many credits does a lists 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 the member exists, even if they have no public lists. not_found means the username does not exist, and data.user is null.