Film rating and histogram collection
Use Letterboxd endpoints to turn film rating and histogram collection into repeatable API requests with documented inputs and JSON responses.
Collect Letterboxd film detail with average rating and rating histogram, member reviews, similar films, cast and crew (people) detail, member profiles, and popular film charts as normalized JSON for film catalogs, ratings research, and enrichment. Credential-free.
Extract Letterboxd film detail, ratings histograms, reviews, similar films, people, members, and popular charts as structured JSON from public pages.
Endpoint families
5
Documented params
25
Examples
8
Live catalog snapshot
Active endpoints
8
Methods
GET
Required params
15
Schema refs
8
{
"platform": "Letterboxd",
"endpoint": "letterboxd-search",
"method": "GET",
"path": "/letterboxd/search",
"auth": "apiKey"
}Use cases
Extract Letterboxd film detail, ratings histograms, reviews, similar films, people, members, and popular charts as structured JSON from public pages.
Use Letterboxd endpoints to turn film rating and histogram collection into repeatable API requests with documented inputs and JSON responses.
Use Letterboxd endpoints to turn review and popularity monitoring into repeatable API requests with documented inputs and JSON responses.
Use Letterboxd endpoints to turn film catalog and people enrichment into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Letterboxd endpoint catalog — 8 endpoints, 25 documented request parameters, and 8 published response schemas — the same catalog Docs and Playground run against.
8 documented Letterboxd endpoints, grouped into 5 request families — Film, Member and Person, plus 2 more.
25 request parameters are documented across those Letterboxd endpoints, 15 of them required — the full input contract is public before you write any integration code.
8 of the 8 Letterboxd endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Letterboxd endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Letterboxd endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/letterboxd/film/{slug}
/letterboxd/member/{username}
/letterboxd/person/{slug}
/letterboxd/popular
/letterboxd/search
Endpoint catalog
/letterboxd/searchSearches 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.
Sampled 14 Oct 2026: 20 items, 4 fields filled in every item, 1 not. year: 1,925 to 2,024, median 2,006; uri: letterboxd.com.
MCP tool letterboxd_search
/letterboxd/popularReturns 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.
Sampled 14 Oct 2026: 20 items, 3 fields filled in every item. uri: letterboxd.com.
MCP tool letterboxd_popular
/letterboxd/film/{slug}Returns a Letterboxd film: synopsis, director, cast, genres, countries, languages, runtime, and aggregate member rating.
Sampled 14 Oct 2026: 25 items, 2 fields filled in every item.
MCP tool letterboxd_film
/letterboxd/film/{slug}/rating-histogramReturns a film's full star-rating distribution (0.5 to 5.0 in half-star buckets) with counts and percentages.
Sampled 14 Oct 2026: 10 items, 3 fields filled in every item. stars: 0.5 to 5, median 2.5; count: 5,659 to 2,936,855, median 42,642.
MCP tool letterboxd_film_rating_histogram
/letterboxd/film/{slug}/reviewsReturns 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.
Sampled 14 Oct 2026: 12 items, 5 fields filled in every item, 3 not. date: 2019-07-21 to 2020-02-10; like_count: 11,199 to 44,671, median 16,605.
MCP tool letterboxd_film_reviews
/letterboxd/film/{slug}/similarLists 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.
Sampled 14 Oct 2026: 20 items, 3 fields filled in every item. uri: letterboxd.com.
MCP tool letterboxd_film_similar
/letterboxd/person/{slug}Returns 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.
Sampled 14 Oct 2026: 19 items, 3 fields filled in every item. uri: letterboxd.com.
MCP tool letterboxd_person
/letterboxd/member/{username}Returns a member's public profile stats (films watched, lists, following/followers). No private data — everything is visible to a logged-out visitor.
Sampled 14 Oct 2026: 8 of 8 fields returned with a value. films_watched: 2,592; uri: letterboxd.com.
MCP tool letterboxd_member
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
How to scrape Letterboxd
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. A pull on 2026-10-27 showed popular returning 10 films led by Interstellar, and Parasite (parasite-2019) returning a 133-minute runtime and a 25-person cast list.
/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.
search for parasite returned 10 results, the first the film Parasite (2019) with slug parasite-2019. The year in a slug disambiguates remakes, so always store it.
film returned release_date 2019-05-21, runtime 133 minutes, director Bong Joon Ho, 25 cast entries and genres including Thriller.
Agent skills
Install a Crawlora agent skill and your agent can pull Letterboxd data as JSON through the documented API, without writing a scraper. These skills cover Letterboxd:
Researches movies and TV shows — metadata, cast/crew, ratings, reviews, streaming availability, and box-office performance — via the Crawlora API…
npx skills add github.com/Crawlora-org/crawlora-skills --skill movie-tv-researchFAQ
Yes. /letterboxd/film/{slug}/rating-histogram returns counts and percentages for all ten half-star steps, not just the average.
Yes. Each review from /letterboxd/film/{slug}/reviews carries contains_spoilers, along with like and comment counts.
Letterboxd adds the year to disambiguate titles, as in parasite-2019. Take slugs from /letterboxd/search or the popular chart rather than constructing them.
To distinguish films with the same title. Parasite's slug on 2026-10-27 was parasite-2019.