API Reference
Extract Letterboxd film detail, ratings histograms, reviews, similar films, people, members, and popular charts as structured JSON from public pages. 8 endpoints documented below.
curl "https://api.crawlora.net/api/v1/letterboxd/search?q=Parasite" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Letterboxd endpoints return film detail, half-star rating histograms, reviews, similar films, people, member stats, and the popular charts as normalized JSON. Letterboxd's rating data is unusually granular. Parasite's histogram on 2026-09-18 covered 5,849,962 ratings across ten half-star buckets, with half of them at five stars, against an average of 4.52.
/letterboxd/film/{slug}/rating-histogram returns ten buckets from 0.5 to 5 stars, each with a count and percent, plus total_ratings. /letterboxd/film/{slug} adds average, count, and review_count, along with runtime_minutes, directors, cast, genres, countries, languages, and production companies.
/letterboxd/film/{slug}/reviews returns reviews ordered by activity, each with username, whether the reviewer liked the film, the date, text, a contains_spoilers flag, like_count, and comment_count. One Parasite review had 44,211 likes.
/letterboxd/popular takes period (day, week, month, or year), genre, and decade. Horror in the 2020s for the year returned a different list from the unfiltered year chart, which confirms the filters apply.
/letterboxd/person/{slug} with role actor or director lists that person's films, /letterboxd/member/{username} returns a member's public stats (films watched, lists, followers), and /letterboxd/film/{slug}/similar returns related titles. Film slugs include the year when titles collide, as in parasite-2019.
/letterboxd/film/{slug}apiKey3 credits/requestReturns a Letterboxd film: synopsis, director, cast, genres, countries, languages, runtime, and aggregate member rating.
Required: slug.
Sampled 14 Oct 2026: 25 items. Filled in every item: name, slug.
/letterboxd/film/{slug}/rating-histogramapiKey1 credit/requestReturns a film's full star-rating distribution (0.5 to 5.0 in half-star buckets) with counts and percentages.
Required: slug.
Sampled 14 Oct 2026: 10 items. Filled in every item: stars, count, percent. In the sample: stars: 0.5 to 5, median 2.5; count: 5,659 to 2,936,855, median 42,642; percent: 0 to 50, median 1.
/letterboxd/film/{slug}/reviewsapiKey2 credits/requestReturns popular reviews for a Letterboxd film by `slug`, up to `limit` (default 10, max 50). Each review has the username, display name, rating from 0.5 to 5.0 when the reviewer gave one, liked flag, date, text, spoiler flag, and like and comment counts.
Required: slug. Optional: limit.
Sampled 14 Oct 2026: 12 items. Filled in every item: username, display_name, date, like_count, comment_count. Not in every item: liked (11), text (2), contains_spoilers (6). In the sample: date: 2019-07-21 to 2020-02-10; like_count: 11,199 to 44,671, median 16,605; liked: true in 11 of 11; text: median 417 characters; contains_spoilers: true in 6 of 6; comment_count: 7 to 248, median 29.
/letterboxd/film/{slug}/similarapiKey2 credits/requestLists films Letterboxd recommends as similar to the film given by `slug`, up to `limit` (default 10, max 50). Each film has its `slug`, title and Letterboxd URL. Use the slug to look up that film's details.
Required: slug. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: slug, title, uri. In the sample: uri: letterboxd.com.
/letterboxd/member/{username}apiKey1 credit/requestReturns a member's public profile stats (films watched, lists, following/followers). No private data — everything is visible to a logged-out visitor.
Required: username.
Sampled 14 Oct 2026: 8 fields returned with a value. In the sample: films_watched: 2,592; uri: letterboxd.com; films_this_year: 113; lists: 158; following: 79; followers: 36,435.
/letterboxd/person/{slug}apiKey2 credits/requestReturns a person's Letterboxd filmography by `slug`, ranked by popularity for one credit role. `role` is `actor` (default) or `director`, and `limit` defaults to 10 with a max of 50. The response has the person's name, role, and films with `slug`, title and Letterboxd URL.
Required: slug. Optional: role (2 allowed values: actor, director), limit.
Sampled 14 Oct 2026: 19 items. Filled in every item: slug, title, uri. In the sample: uri: letterboxd.com.
/letterboxd/popularapiKey2 credits/requestReturns a Letterboxd film chart ranked by popularity. Omit `period` for all-time, or set `day`, `week`, `month` or `year`. `genre` takes a genre slug, `decade` a value like `2010s`, and `limit` defaults to 10 with a max of 50. Each film has its `slug`, title and Letterboxd URL.
Optional: period (4 allowed values: day, week, month, year), genre, decade, limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: slug, title, uri. In the sample: uri: letterboxd.com.
/letterboxd/searchapiKey2 credits/requestSearches Letterboxd for films, people, lists and tags by `q`, required. `type` can be set to `film` to return films only; `limit` defaults to 10 with a max of 50. Fields vary by result type: films carry `slug` and `year`, people carry `slug` and `role`, lists carry `owner`, and tags carry only a title and URL.
Required: q. Optional: type (film), limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: type, title, slug, uri. Not in every item: year (19). In the sample: year: 1,925 to 2,024, median 2,006; uri: letterboxd.com.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get a Letterboxd film | GET /letterboxd/film/parasite-2019 | 100% | 1.14 s |
| Get a Letterboxd film's rating distribution | GET /letterboxd/film/parasite-2019/rating-histogram | 100% | 0.93 s |
| Get a Letterboxd film's popular reviews | GET /letterboxd/film/parasite-2019/reviews | 100% | 1.05 s |
| Get films similar to a Letterboxd film | GET /letterboxd/film/parasite-2019/similar | 100% | 1.07 s |
| Get a Letterboxd member's public profile stats | GET /letterboxd/member/dave | 100% | 1.15 s |
| Get a Letterboxd person's filmography | GET /letterboxd/person/bong-joon-ho?role=director | 100% | 1.05 s |
| Get a Letterboxd popularity-ranked film chart | GET /letterboxd/popular?period=week | 100% | 0.96 s |
| Search Letterboxd | GET /letterboxd/search?q=Parasite | 100% | 1.10 s |