🎬 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	Also extract user reviews per film (default: true)
Max Reviews Per Film	Cap reviews per film (default: 20, max: 200)
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

Field	Description
filmSlug	Film the review belongs to
filmTitle	Film title
reviewer	Reviewer's Letterboxd username
rating	Reviewer's star rating (0–5)
reviewText	Full review text
reviewDate	Date of review
likes	Number of likes on the review

---

📌 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

---

✅ 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.