Letterboxd Film & Reviews Scraper

Letterboxd Film & Reviews Scraper turns Letterboxd into structured film data you can reuse anywhere. Search by title phrase or paste Letterboxd film and browse-list links, and get ratings, directors, genre, runtime, and tagline for every matched film, with reader reviews available as an optional per-film add-on. Export to JSON, CSV, or Excel, or pull results straight into your app through the API.

Why This Scraper?

• Two clear modes: search by film title phrase, or paste Letterboxd film pages and browse lists such as popular or genre lists.
• Real film metadata in every row: title, release year, directors, genre, average rating, ratings count, runtime, and tagline.
• Optional reader reviews per film: author handle, star rating, review date, text, likes, and spoiler flag, billed only when turned on.
• Output caps apply in both modes, so a pasted-URL run can still be limited with Max items.
• Resume and recurring updates: continue one interrupted run with Resume, or turn on Incremental mode to get only new, updated, and reappeared films on a schedule.
• MCP connector export sends a concise film summary into Notion, Linear, Airtable, or Apify while the complete record always stays in the dataset.

Use Cases

• Film bloggers and critics: pull ratings, taglines, and directors to enrich reviews and roundup posts.
• Data journalists and researchers: build historical rating datasets across genres, decades, or directors.
• Watch-list and recommendation tools: track new releases and rating changes with Incremental mode.
• Audience and sentiment teams: read reader review text and star ratings for a title or a set of titles.
• Catalogers and archivists: collect structured metadata for a curated list of titles from pasted URLs.

Data You Get

Sample shape: values are illustrative placeholders, not from a live listing.

Field	Example
url	https://letterboxd.com/film/sample-film-title/
slug	sample-film-title
title	Sample Film Title
image	https://a.ltrbxd.com/resized/sample-poster.jpg
description	A one-paragraph synopsis of the film.
genre	["Drama", "Mystery"]
directors	["Sample Director"]
averageRating	3.8
averageRatingPrecise	3.76
ratingsCount	125000
datePublished	2023-05-01
releaseYear	2023
runtimeMinutes	118
tagline	A story worth telling.
scrapedAt	2026-01-01T00:00:00Z
reviews	reader reviews array, present only when Fetch reader reviews is on
changeType	"NEW", incremental mode only
changedFields	["averageRating"], incremental mode only
firstSeenAt	2026-01-01T00:00:00Z, incremental mode only
lastSeenAt	2026-01-05T00:00:00Z, incremental mode only

Each entry inside reviews carries filmSlug, author, rating, reviewDate, text, likes, and containsSpoilers.

How to Use

1. Pick a mode: search (film title phrases) or url (paste Letterboxd film and browse links).
2. Fill in the fields for that mode, and turn on Fetch reader reviews if you also want per-film review text and star ratings.
3. Set Max items to control run size and cost, then click Start.
4. Download the dataset as JSON, CSV, or Excel, or read it through the API.

Search by title phrase:

{
  "mode": "search",
  "queries": ["dune"],
  "maxItems": 20
}

Search multiple phrases with reviews enrichment:

{
  "mode": "search",
  "queries": ["dune", "oppenheimer"],
  "fetchReviews": true,
  "maxReviewsPerFilm": 25,
  "maxItems": 25
}

Paste Letterboxd URLs:

{
  "mode": "url",
  "startUrls": [
    { "url": "https://letterboxd.com/films/popular/" },
    { "url": "https://letterboxd.com/film/dune-part-two/" }
  ],
  "maxItems": 10
}

Recurring incremental run (same search every day):

{
  "mode": "search",
  "queries": ["dune"],
  "incrementalMode": true
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/letterboxd-film-reviews-scraper").call(run_input={"mode": "search", "queries": ["dune"]})
for film in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(film["title"], film["averageRating"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/letterboxd-film-reviews-scraper').call({ mode: 'search', queries: ['dune'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets, or webhooks from the Integrations tab.

Output caps in both modes

maxItems is the primary cap and applies to search and URL mode alike, so a pasted list of browse links can still be limited to a fixed number of films. maxPages additionally bounds how many browse-list pages are read per source (search mode is capped by maxItems alone); leave it empty to walk every result page and let maxItems do the capping.

Resume and recurring updates

• Resume (resumeFromRunId) continues one interrupted run: paste its run or dataset ID and the actor skips films already collected there (matched by slug), so you do not pay twice.
• Incremental mode (incrementalMode) is for scheduled runs over the same search or URLs. Each film is classified NEW, UPDATED (with changedFields), UNCHANGED (suppressed and not billed unless emitUnchanged is on), REAPPEARED, or EXPIRED (only after a run that scanned the whole scope end to end, and only with emitExpired). stateKey names or shares the stored state; leave it empty to isolate state automatically by mode, queries, URLs, and browse path. With Incremental mode off, output is exactly as before.

Send results into your apps (MCP connectors)

Optionally pipe the scraped films into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape: the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each film, not the full JSON. Notion gets a page-per-film export; other connectors receive a best-effort write or digest. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify > Settings > API & Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you have not authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where film pages should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Connector write errors do not fail the run. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search for title-phrase search, or url for pasted Letterboxd links.
queries	array	["dune"]	Film title phrases for search mode.
startUrls	array	sample URL	Letterboxd film pages, browse lists, or direct film slugs for URL mode.
browsePath	string	/films/popular/	Used only in URL mode when Start URLs is empty; a site path to browse.
maxItems	integer	20	Maximum films to return across the whole run. Must be at least 1.
maxPages	integer	0 (unlimited)	Maximum pages to read per browse-list source (not used by search mode). Leave at 0 to walk every result page; Max items is the primary output cap.
fetchReviews	boolean	false	Turn on to also fetch reader reviews for each returned film, charged as a separate per-film enrichment event.
maxReviewsPerFilm	integer	25	Only used when Fetch reader reviews is on. Maximum reviews to collect per film.
resumeFromRunId	string	(none)	Previous run ID or dataset ID from this actor. Films already collected there (matched by slug) are skipped, so the run returns only new ones.
incrementalMode	boolean	false	Daily or recurring monitoring of the same search or URLs. The first run returns everything as NEW; later runs return only NEW, UPDATED, and REAPPEARED by default.
stateKey	string	(none)	Optional name for a monitoring campaign, so its incremental state stays stable or is deliberately shared. Auto-derived from mode, queries, URLs, and browse path when left empty.
emitUnchanged	boolean	false	Incremental mode only. Also return films unchanged since the last run, marked UNCHANGED. Adds and bills extra rows you already have.
emitExpired	boolean	false	Incremental mode only. Also return films from a previous run no longer found, marked EXPIRED, once a run has fully scanned the search. Adds and bills extra synthetic rows.
proxy	object	Apify Proxy	Connection settings. The default is recommended for Letterboxd.
mcpConnectors	array	(none)	Optional connector IDs for sending a concise summary into your apps.
notionParentPageUrl	string	(none)	Notion connector only: page under which film pages are created.
maxNotifyListings	integer	50	Cap on how many films are written to each selected connector per run. Does not affect the dataset.

Output Example

Sample shape: values are illustrative placeholders, not from a live listing.

{
  "url": "https://letterboxd.com/film/sample-film-title/",
  "slug": "sample-film-title",
  "title": "Sample Film Title",
  "image": "https://a.ltrbxd.com/resized/sample-poster.jpg",
  "description": "A one-paragraph synopsis of the film.",
  "genre": ["Drama", "Mystery"],
  "directors": ["Sample Director"],
  "averageRating": 3.8,
  "averageRatingPrecise": 3.76,
  "ratingsCount": 125000,
  "datePublished": "2023-05-01",
  "releaseYear": 2023,
  "runtimeMinutes": 118,
  "tagline": "A story worth telling.",
  "reviews": [
    {
      "filmSlug": "sample-film-title",
      "author": "sample_reviewer",
      "rating": 3.5,
      "reviewDate": "2026-01-03",
      "text": "A short, generic reaction to the film.",
      "likes": 2,
      "containsSpoilers": false
    }
  ],
  "scrapedAt": "2026-01-01T00:00:00Z"
}

reviews is only present when Fetch reader reviews is on.

Plan Requirement

For best reliability, keep the default Apify proxy setting. Max items is a maximum cap, not a guaranteed count; a run can save fewer rows when the selected search phrase, URL, or browse path matches fewer films.

FAQ

How much does it cost?

You pay per film returned, with optional reader reviews billed only when you turn on Fetch reader reviews. The Pricing tab shows the current rates. Use Max items to cap the cost of any run.

Is it legal to scrape Letterboxd?

This actor collects only publicly available film and review data. You are responsible for how you use it: follow Letterboxd's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution, especially of reader-written review text.

What is the difference between Resume and Incremental mode?

Resume (resumeFromRunId) continues one specific interrupted run from a pasted run or dataset ID. Incremental mode is for a schedule, for example daily or weekly: the actor remembers the previous run of the same search or URLs by itself and returns only new, updated, and reappeared films. Use one or the other; a state key that already has saved incremental state cannot also be combined with Resume.

Can I get only new or changed films on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only new, updated, and reappeared films by default, and unchanged ones are not billed unless you turn that on too.

Why did my run fail instead of returning an empty dataset?

If every page the run tried was refused, the run stops with a clear message so "no matching films" is never confused with "nothing could be read." Run it again in a few minutes. If only some pages could not be read, you still get what was found.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear, or Airtable.

🔗 More scrapers you might like

Pair this actor with these related scrapers from the same team:

🧩 Allegro Scraper Scrape Allegro by keyword or URL. Extract offers, prices, delivery, seller details, and...	💼 Wellfound Jobs Scraper Scrape startup jobs from Wellfound.com by keyword, location, role, or remote status...
📇 Apple App Store Reviews Scrape Apple App Store reviews across 150+ country storefronts. Search by app name or URL...	🧩 Jumia Marketplace Scraper Scrape Jumia, Africa's largest marketplace: products with local prices, discounts...
🧩 TIDAL Scraper Scrape TIDAL tracks, albums, artists, playlists and public mixes by search phrase or URL...	🧩 WEBTOON Scraper Scrape the WEBTOON catalog into structured data. Extract series, genres, rankings and...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email abotapi@proton.me or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.