Letterboxd Films, Ratings & Lists Scraper

Letterboxd Films, Ratings & Lists Scraper

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.

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
}

The example above shows the first 25 of 33 fields.

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.

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
}

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.

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.