> **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-tags>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/letterboxd/users-username-tags.mdx>

---

# Letterboxd Tags API

A member's tags with their film counts, most used first, ready to join to films and reviews.

`GET /v1/letterboxd/users/{username}/tags` returns `data.user`, and `data.tags`. Each tag has `name`, `slug` and `count`. The name keeps the member's own spelling and spaces, while the slug is the URL form, so `criterion channel` and `criterion-channel` appear together as name and slug. `count` is the number of films under the tag and is nullable when not available.

One call returns up to 120 tags; there is no `page` or `cursor` parameter and no next page. Tags are ordered by use. Join the name or slug to reviews and lists that carry tags.

## Request

- **Endpoint:** `GET /v1/letterboxd/users/{username}/tags`
- **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/tags/get)
- **Platform page:** [/platforms/letterboxd](https://www.socialfetch.dev/platforms/letterboxd)

## FAQ

### What is the difference between name and slug?

name is the tag as the member wrote it, including spaces and capitalisation. slug is the lowercase path form used in URLs. Both are returned so you can display one and link or join with the other.

### How many tags does one call return?

Up to 120, the most used first. The route takes no page or cursor, so a member with more tags than that gets the first 120 only.

### Why can count be null?

The count is nullable because it is not always available. A null means unknown, while a number is the films under that tag at the time of the response.

### How many credits does a tags 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 with no tags. not_found means the username does not exist, and data.user is null.