Letterboxd Films, Ratings & Lists Scraper

Here is one real result, with every field the actor returns (cast trimmed to the first 8 of 20 real names, all other values shown in full):

{
  "imageUrl": "https://a.ltrbxd.com/resized/sm/upload/e9/3l/l6/pt/dune-0-600-0-900-crop.jpg?v=a79bf8b4f6",
  "title": "Dune",
  "url": "https://letterboxd.com/film/dune/",
  "slug": "dune",
  "year": 1984,
  "directors": ["David Lynch"],
  "averageRating": 2.85,
  "ratingCount": 295727,
  "reviewCount": 86755,
  "watchCount": null,
  "likeCount": null,
  "listCount": null,
  "runtimeMinutes": 136,
  "genres": ["Adventure", "Science Fiction", "Action"],
  "cast": ["Kyle MacLachlan", "Francesca Annis", "Patrick Stewart", "Linda Hunt", "Jose Ferrer", "Freddie Jones", "Brad Dourif", "Richard Jordan"],
  "synopsis": "In the year 10,191, the most precious substance in the universe is the spice Melange. The spice extends life. The spice expands consciousness. The spice is vital to space travel. The spice exists on only one planet in the entire universe, the vast desert planet Arrakis, also known as Dune. Its native inhabitants, the Fremen, have long held a prophecy that a man would come, a messiah who would lead them to true freedom.",
  "tagline": "A world beyond your experience, beyond your imagination.",
  "languages": ["en"],
  "countries": ["USA"],
  "studios": ["The De Laurentiis Company"],
  "imdbId": "tt0087182",
  "tmdbId": "841",
  "imdbUrl": "https://www.imdb.com/title/tt0087182/",
  "tmdbUrl": "https://www.themoviedb.org/movie/841",
  "memberRating": null,
  "liked": null,
  "listRank": null,
  "memberUsername": null,
  "searchTerm": "dune",
  "sourceType": "search",
  "source": "Letterboxd",
  "observedAt": "2026-08-15T08:18:56.086Z",
  "error": null
}

The most complete Letterboxd scraper available. It returns every field a Letterboxd film page exposes (average rating out of 5, rating and review counts, runtime, genres, full cast, directors, synopsis, studios, countries, languages), plus cross-reference fields (IMDb and TMDB IDs and URLs) and member-context fields, and it accepts five source types (film pages, member profiles, watchlists, lists, and browse pages) so you can target exactly the films you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor takes a film keyword and/or one or more Letterboxd URLs, resolves each to the films behind it, fetches every film page, and writes one normalized record per film to the run's dataset. It handles five source types: individual film pages, member profile film lists, watchlists, ranked lists, and film browse pages. Numeric ratings are normalized to a 0 to 5 scale, missing source values are returned as null, and each film is enriched with IMDb and TMDB identifiers so you can join Letterboxd data to other movie datasets.

Data covers the public Letterboxd film catalog and public member activity. It does not read private profiles, private lists, or anything behind a Letterboxd login.

Quickstart

Open the actor, paste this into the input, and press Run. It looks up one film by keyword and returns the full film record.

{
  "searchTerm": "dune",
  "maxFilms": 3,
  "withDetails": true
}

You can also pass startUrls with film pages, member profiles, watchlists, lists, or browse pages instead of (or in addition to) a keyword. Every input field is optional except that you must provide at least a searchTerm or one startUrls entry.

Input reference

Field	Type	Required	Default	Description
searchTerm	string	no	(empty)	A film title keyword to look up, for example dune. Resolves to the canonical Letterboxd film and is always fully detailed. For an exact film, use startUrls with the film URL instead.
startUrls	array	no	(empty)	Letterboxd URLs to scrape. Accepts film pages (letterboxd.com/film/dune-2021/), member profiles (letterboxd.com/dave/films/), watchlists (letterboxd.com/dave/watchlist/), lists (letterboxd.com/dave/list/imdb-top-250/), and film browse pages (letterboxd.com/films/popular/).
maxFilms	integer	no	10	Maximum number of films to collect across all inputs. Free Apify plans are capped at 10 per run.
withDetails	boolean	no	true	When on, each film pulled from a member profile, watchlist, list, or browse page is enriched with its full film page (director, average rating, genres, cast, synopsis, runtime, studios). Direct film URLs and keyword searches are always fully detailed.

You must provide at least a searchTerm or one startUrls entry. If you pass neither, the actor writes a single item with a populated error field and does not charge.

Output reference

One dataset item per film. Types: string, integer, number, boolean, string[], or null when the source value is absent.

Field	Type	Description
imageUrl	string	URL of the film poster image.
title	string	Film title.
url	string	Canonical Letterboxd film page URL.
slug	string	Letterboxd film slug (unique per film), for example dune.
year	integer	Release year, or null if unknown.
directors	string[]	Director names.
averageRating	number	Average member rating on a 0 to 5 scale.
ratingCount	integer	Number of member ratings.
reviewCount	integer	Number of written reviews.
watchCount	integer	Number of members who logged the film, or null when Letterboxd does not expose it.
likeCount	integer	Number of members who liked the film, or null when not exposed.
listCount	integer	Number of lists the film appears in, or null when not exposed.
runtimeMinutes	integer	Runtime in minutes.
genres	string[]	Genre labels.
cast	string[]	Cast member names, in billing order.
synopsis	string	Plot synopsis text.
tagline	string	Marketing tagline, or null.
languages	string[]	Language codes.
countries	string[]	Production countries.
studios	string[]	Production studios or companies.
imdbId	string	IMDb title identifier, for example tt0087182, or null.
tmdbId	string	TMDB movie identifier, or null.
imdbUrl	string	Full IMDb title URL, or null.
tmdbUrl	string	Full TMDB movie URL, or null.
memberRating	number	The member's own rating on a 0 to 5 scale when the film came from a profile or list, else null.
liked	boolean	Whether the member liked the film when known, else null.
listRank	integer	Position of the film in a ranked list, else null.
memberUsername	string	Username of the member profile, watchlist, or list the film came from, else null.
searchTerm	string	The keyword that resolved to this film, else null.
sourceType	string	Where the film came from: search, film, member, watchlist, list, or browse.
source	string	Always Letterboxd.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"startUrls":[{"url":"https://letterboxd.com/film/dune-part-two/"}]}, cast trimmed to the first 6 real names):

{
  "imageUrl": "https://a.ltrbxd.com/resized/film-poster/6/1/7/4/4/3/617443-dune-part-two-0-600-0-900-crop.jpg?v=cc533700f8",
  "title": "Dune: Part Two",
  "url": "https://letterboxd.com/film/dune-part-two/",
  "slug": "dune-part-two",
  "year": 2024,
  "directors": ["Denis Villeneuve"],
  "averageRating": 4.38,
  "ratingCount": 3561676,
  "reviewCount": 942423,
  "watchCount": null,
  "likeCount": null,
  "listCount": null,
  "runtimeMinutes": 167,
  "genres": ["Adventure", "Science Fiction"],
  "cast": ["Timothee Chalamet", "Zendaya", "Rebecca Ferguson", "Javier Bardem", "Josh Brolin", "Austin Butler"],
  "synopsis": "Follow the mythic journey of Paul Atreides as he unites with Chani and the Fremen while on a path of revenge against the conspirators who destroyed his family. Facing a choice between the love of his life and the fate of the known universe, Paul endeavors to prevent a terrible future only he can foresee.",
  "tagline": "Long live the fighters.",
  "languages": ["en"],
  "countries": ["USA"],
  "studios": ["Legendary Pictures"],
  "imdbId": "tt15239678",
  "tmdbId": "693134",
  "imdbUrl": "https://www.imdb.com/title/tt15239678/",
  "tmdbUrl": "https://www.themoviedb.org/movie/693134",
  "memberRating": null,
  "liked": null,
  "listRank": null,
  "memberUsername": null,
  "searchTerm": null,
  "sourceType": "film",
  "source": "Letterboxd",
  "observedAt": "2026-08-15T08:19:13.423Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~letterboxd-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm":"dune","maxFilms":3,"withDetails":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~letterboxd-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://letterboxd.com/dave/watchlist/"}],"maxFilms":100}'

Apify CLI:

apify call scrapers_lat/letterboxd-scraper \
  --input '{"startUrls":[{"url":"https://letterboxd.com/films/popular/"}],"maxFilms":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per film record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors or no input is provided, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 films per run. Upgrade for higher maxFilms.

FAQ and troubleshooting

A run returned only an error item. Why? You passed neither a searchTerm nor any startUrls. Provide a film keyword or at least one Letterboxd URL. Error-only runs are not charged.

Why are watchCount, likeCount, or listCount null? Letterboxd does not always expose those counters on the film page. Missing source values are returned as null, never invented.

How do I scrape a member's whole diary or watchlist? Pass the member films URL (letterboxd.com/<user>/films/) or watchlist URL (letterboxd.com/<user>/watchlist/) in startUrls. Films from those sources carry memberRating, liked, and memberUsername.

What rating scale does the actor use? All ratings are normalized to a 0 to 5 scale, matching how members rate on Letterboxd.

Can I join this data to IMDb or TMDB? Yes. Each film includes imdbId, tmdbId, imdbUrl, and tmdbUrl when Letterboxd links them, so you can match records across datasets.

Is this an official Letterboxd tool? No. This actor is independent and has no affiliation with Letterboxd. It reads only data that is publicly available on the Letterboxd website.

Related scrapers

• IMDb Titles Scraper: Films and shows with ratings, cast, and crew from IMDb.
• IMDb Reviews Scraper: User reviews and ratings for any IMDb title.
• Goodreads Scraper: Books, ratings, and reviews from Goodreads.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Letterboxd. Accesses only publicly available Letterboxd data.