🎬 Letterboxd Film & Review Scraper: Ratings, Reviews & User Data Extractor

The fastest way to extract film ratings, user reviews, cast & crew, genres, and list data from Letterboxd — the world's leading social film discovery platform with 17M+ registered members and 50M+ monthly visits.
Built for recommendation engines, sentiment analysis, film research, and data pipelines — static HTML parsing, no JavaScript rendering required.

✅ If you searched "letterboxd scraper", "letterboxd reviews API", "scrape letterboxd ratings", "letterboxd data extractor", or "letterboxd film list scraper" — this Actor is built exactly for that.

---

📺 Getting Started: Official Tutorial (Apify)

New to Apify? Watch this official guide to learn how to run an Actor and export your data in minutes:

---

✨ Key Features

• 🎯 4 Scrape Modes: Film details, user profiles, curated lists, and keyword search.
• ⭐ Ratings & Reviews: Average rating, total ratings count, and full user review text with reviewer info.
• 🎭 Rich Film Metadata: Director, cast, genres, runtime, language, country, tagline, and poster.
• 👤 User Profile Scraping: Extract a user's full watched film history and personal ratings.
• 📋 List Scraping: Scrape any public Letterboxd list — top 250, user-curated collections, etc.
• 🔍 Keyword Search: Find films by title and optionally follow through to full film details.
• 📄 Automatic Pagination: All modes handle multi-page results automatically.
• 🛡️ Proxy-Ready: Residential proxy support for reliable, uninterrupted runs.

---

📈 Why Letterboxd? (Market Opportunity)

• 17M+ registered members and growing
• 50M+ monthly visits — top-tier film community traffic
• A new member joins every 5 seconds
• The only deprecated Letterboxd actor on Apify still receives search traffic
• Heavy demand from AI/ML teams building film recommendation and sentiment models
• Difficulty: Low — clean, semantic static HTML structure

---

🛠️ Use Cases

🤖 AI & Recommendation Engines

Build training datasets for film recommendation models. Letterboxd's community ratings are considered more nuanced and cinephile-accurate than mainstream platforms.

📊 Sentiment Analysis

Extract thousands of user reviews with star ratings for NLP training, sentiment classification, or opinion mining.

🎯 Film Research & Journalism

Analyze rating distributions, genre trends, director reception, or year-by-year audience preferences at scale.

📋 List Intelligence

Scrape Letterboxd's famous community lists (Top 250, decade lists, genre lists) for editorial, recommendation, or research purposes.

👤 Audience Profiling

Extract user watch histories to understand viewing patterns, taste profiles, and genre affinities.

---

📥 Input Configuration

Field	Description
Mode	film — Film details + reviews · user — User watch history · list — Scrape a list · search — Search by keyword
Start URLs	Letterboxd film, user profile, or list URLs
Search Keywords	Film titles or keywords (search mode)
Scrape Reviews	Extract user reviews per film as their own dataset rows (default: true)
Fetch Full Review Text	Fetch the complete text of long/truncated reviews (default: true)
Max Reviews Per Film	Cap reviews per film (default: 20, max: 1000)
Max Films	Cap total films for user/list/search modes (default: 50)
Proxy Configuration	Residential proxy recommended

Example Inputs

Film details + reviews:

{
  "mode": "film",
  "startUrls": [
    { "url": "https://letterboxd.com/film/the-godfather/" },
    { "url": "https://letterboxd.com/film/inception/" }
  ],
  "scrapeReviews": true,
  "maxReviews": 50
}

User watch history:

{
  "mode": "user",
  "startUrls": [
    { "url": "https://letterboxd.com/username/" }
  ],
  "maxFilms": 200
}

Scrape a list:

{
  "mode": "list",
  "startUrls": [
    { "url": "https://letterboxd.com/dave/list/official-top-250-narrative-feature-films/" }
  ]
}

Search films:

{
  "mode": "search",
  "searchQueries": ["stanley kubrick", "neon noir 2020s"],
  "maxFilms": 30
}

---

📤 Output & Data Structure

Film Record

Field	Description
type	Record type: film, review, user_film, list_film, search_result
filmSlug	Letterboxd film slug (e.g. the-godfather)
title	Film title
year	Release year
director	Director name(s)
cast	Top cast members (up to 10)
genres	Genre list
runtime	Runtime in minutes
averageRating	Letterboxd average rating (0–5 scale)
ratingsCount	Total number of ratings
language	Primary language
country	Country of origin
tagline	Film tagline or synopsis
posterUrl	Film poster image URL
filmUrl	Direct Letterboxd URL
scrapedAt	ISO timestamp of extraction

Review Record

Each user review is saved as its own row (type: "review") — ready to export straight to CSV/Excel or feed into an NLP pipeline.

Field	Description
type	Always review
filmTitle	Film the review belongs to
filmYear	Film release year
filmSlug	Letterboxd film slug
filmUrl	Direct film URL
reviewer	Reviewer's display name
username	Reviewer's Letterboxd username
rating	Reviewer's star rating (0–5, or empty if unrated)
reviewText	Full review text
isSpoiler	Whether the review is flagged as a spoiler
likes	Number of likes on the review
reviewUrl	Direct URL to the review
reviewDate	Date of the review (when available)

---

📌 SEO Keywords (What This Actor Helps With)

• Letterboxd scraper
• Letterboxd film data extractor
• Letterboxd reviews API alternative
• Scrape Letterboxd ratings
• Letterboxd dataset for machine learning
• Letterboxd user watchlist scraper
• Film review sentiment analysis dataset
• Letterboxd list scraper
• Movie ratings scraper
• Film recommendation dataset
• Letterboxd unofficial API
• Letterboxd API alternative
• Export Letterboxd reviews to CSV
• Scrape Letterboxd without login

---

✅ Best Practices

• Use Residential Proxy — Letterboxd blocks datacenter IPs. This is the most important setting for reliable runs.
• For sentiment analysis datasets, set maxReviews to 100–200 and run across 50+ films.
• For list scraping, paste the full list URL including the list slug (e.g. /dave/list/official-top-250-narrative-feature-films/).
• For user profiles, the scraper reads /username/films/ — make sure the profile is public.
• Export as JSON for ML pipelines or CSV for spreadsheet analysis.
• Use type field to filter records: film for metadata, review for NLP, user_film for collaborative filtering.

---

💡 Why This Beats Manual Letterboxd Browsing

Letterboxd has no public API. Its website is the only source of data. This Actor gives you:

• Structured JSON/CSV output instead of manual copy-paste
• Hundreds of reviews extracted in minutes
• Full pagination — not just the first page
• Batch processing across multiple films or lists simultaneously
• Clean, HTML-stripped text ready for NLP pipelines

---

📞 Support

Maintained and kept compatible with Letterboxd's HTML structure by Logiover.
If you need a custom integration (e.g. bulk film datasets, genre-specific extraction, or Letterboxd + IMDb cross-reference), reach out via the Support tab.

Built for researchers, ML engineers, film journalists, and data teams who want Letterboxd data → clean structured output → instant insights.

❓ FAQ

Is this a Letterboxd API alternative?

Yes. Letterboxd has no public API, so this Actor acts as an unofficial API alternative — it parses Letterboxd's static HTML pages and returns structured film ratings, reviews, and user data as JSON.

Can I scrape Letterboxd without an API or login?

Yes. The Actor reads public Letterboxd pages directly with no login or API key required. Use Residential proxy for reliable, uninterrupted runs.

How do I export Letterboxd reviews and ratings to CSV or JSON?

Each film, review, and user-film record is saved as its own dataset row, so you can export the full Letterboxd dataset to CSV, Excel, or JSON straight from the run — ready for spreadsheets or ML pipelines.

Can I export a Letterboxd user's watchlist or watch history?

Yes. Run the Actor in user mode with a public profile URL to extract that user's watched film history and personal ratings as a structured export.

📝 Changelog

2026-06-07

• Docs: added coverage for Letterboxd unofficial API / API alternative, exporting reviews and ratings to CSV/JSON, and scraping without API or login.

2026-06-05

• 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results).
• ⚡ Stability & performance hardening; fresh rebuild.

2026-06-04

• Verified live & refreshed build — reliability/maintenance pass.