Letterboxd Scraper

Films from Letterboxd — average rating, ratings and fan counts, cast, crew, genres, themes and popular reviews — from film pages, lists, member pages and filmographies, as clean JSON.

Letterboxd is where millions of film fans log, rate and review what they watch, which makes it one of the best public signals of how audiences feel about a film. This Actor reads Letterboxd film pages and returns one record per film: title, year, directors, top-billed cast with characters, crew by department, genres and themes, runtime, countries, languages and studios, the Letterboxd average rating with ratings, reviews and fan counts, the poster, and the film's TMDB and IMDb IDs. Paste a film, a list, a member's films or watchlist, or a director's, actor's or studio's page; switch on reviews to add each film's most popular reviews with their full text. No login and no API key. Built for film marketers and distributors, streaming and catalogue teams, entertainment analysts and data journalists, and anyone building on film data.

⚡ Quick start

{
  "startUrls": [{ "url": "https://letterboxd.com/dave/list/imdb-top-250/" }],
  "maxItems": 5
}

Or a few films, with their popular reviews:

{
  "startUrls": [
    { "url": "https://letterboxd.com/film/parasite-2019/" },
    { "url": "https://letterboxd.com/film/the-godfather/" }
  ],
  "includeReviews": true,
  "maxReviews": 5
}

🧩 Input

Field	Type	Required	Default	Description
startUrls	array	yes	—	Letterboxd pages: a film (/film/parasite-2019/), a list (/dave/list/imdb-top-250/), a member's films or watchlist (/dave/films/, /dave/watchlist/), or a person's or studio's page (/director/bong-joon-ho/, /actor/song-kang-ho/, /studio/a24/).
includeReviews	boolean	no	false	Add each film's most popular reviews. Each review costs one extra page, so runs take longer.
maxReviews	integer	no	12	Popular reviews per film when includeReviews is on, from 1 to 12 (Letterboxd shows up to 12 per film).
maxItems	integer	no	—	Maximum number of films per start URL. The input form starts at 5; leave it empty to get every film on a list or member page.
proxyConfiguration	object	no	{ "useApifyProxy": false }	Proxy settings. Letterboxd's public pages work without a proxy.

Which pages work. Film pages, lists, member film grids and filmographies are read page by page until maxItems is reached. Sorted or filtered views (/by/rating/, /genre/horror/, /decade/…) and the "Popular" browse pages are not supported: open the list or member page itself instead.

📤 Output

Each film is one dataset row. Films from a list keep the list's order, and ranked lists add the film's number as listRank. reviews is null unless includeReviews is on.

Fields

Field	Type	Description
slug	string	The film's Letterboxd slug, e.g. parasite-2019.
url	string	The film page on Letterboxd.
filmId	number	Letterboxd's numeric film ID.
shortUrl	string	The film's boxd.it short link.
title	string	Title as Letterboxd shows it.
originalTitle	string	Title in the original language, when it differs.
year	number	Release year.
releaseDate	string	First release date (often the festival premiere), YYYY-MM-DD.
directors	array	Director names.
cast	array	The first 20 billed cast members: name, character and url.
castCount	number	How many cast members Letterboxd lists in total.
crew	array	Crew by department: role (e.g. Writers, Cinematography) and names.
genres	array	Genres.
themes	array	Letterboxd's themes for the film, e.g. "Twisted dark psychological thriller".
runtimeMinutes	number	Running time in minutes.
countries	array	Countries of production.
primaryLanguage	string	The film's main language.
languages	array	Spoken languages.
studios	array	Production studios.
alternativeTitles	array	Other titles the film is known by, in other countries and languages.
tagline	string	The film's tagline.
synopsis	string	Plot summary.
averageRating	number	Letterboxd's weighted average rating, 0.5 to 5.
ratingsCount	number	Number of ratings.
reviewsCount	number	Number of reviews.
fansCount	number	Members who have the film among their four favourites. Letterboxd rounds large numbers (198K → 198000).
posterUrl	string	Poster image.
tmdbId	number	The film's ID on The Movie Database.
imdbId	string	The film's IMDb ID, e.g. tt6751668.
listRank	number	The film's number on the ranked list it came from; null otherwise.
sourceUrl	string	The page the film was found on (the film page itself for a pasted film).
reviews	array	Popular reviews: reviewId, url, reviewerName, reviewerUsername, rating, likedFilm, containsSpoilers, text, publishedAt, likesCount, commentsCount.

💡 Use cases

• Film marketing and distribution — track how a release is rated and talked about, and compare it with comparable titles.
• Catalogue and acquisition research — rank a list or a filmography by audience rating and fan count before licensing.
• Recommendation and data products — join Letterboxd ratings, themes and genres to your catalogue through the TMDB and IMDb IDs.
• Audience sentiment — read the most popular reviews for a film, with spoiler flags and likes.

❓ FAQ

• Do I need a Letterboxd account? No. The Actor reads the same public pages anyone can open.
• Do I need a proxy? No. It runs without one by default.
• How many reviews can I get per film? Up to 12: the most popular reviews Letterboxd shows on the film page, each with its full text and publish date.
• Why is fansCount a round number? Letterboxd shows fan counts rounded (for example "198K fans"); the Actor returns that number in full.
• Can I scrape the "Popular" or genre browse pages? No. Those pages load their films separately and are not supported; use a list, a member's films or a filmography instead.
• How do I follow a list over time? Schedule the Actor on the list and compare runs: listRank, averageRating and ratingsCount change as members rate.

🔗 More scrapers by Anyx

• Steam Scraper
• App Store Scraper
• Trustpilot Scraper
• Reddit Scraper

🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

• Email: tantosthor@gmail.com

🖼 Image credit

Image credit: letterboxd.com