Letterboxd Movies, Reviews & Ratings Scraper

Overview

Fast Letterboxd scraper with hybrid architecture. Uses CheerioCrawler for 3x faster movie metadata extraction, with optional Playwright for user reviews. Scrape ratings, cast, director, genres, and watch statistics.

Features

• Search by keywords to find specific results
• Export data in JSON, CSV, or Excel formats
• Includes ratings and review data
• Built-in proxy support for reliable data collection

Use Cases

• Track - Track entertainment listings and reviews
• Build - Build media databases for content analysis
• Monitor - Monitor entertainment industry trends and ratings
• Aggregate - Aggregate entertainment data for recommendation engines

Input Parameters

Parameter	Type	Description	Default
movieTitle	string	Movie title to search for (e.g., 'Inception', 'The Matrix'). Uses Playwright ...
movieUrl	string	Direct Letterboxd movie URL. FASTEST MODE when combined with includeReviews=f...
includeReviews	boolean	Scrape user reviews for each movie. Requires Playwright. Set to false for max...	true
maxReviews	integer	Maximum number of reviews to scrape per movie (only used when Include Reviews...	20
maxMovies	integer	Maximum number of movies to scrape (for search mode)	50
proxyConfiguration	object	Proxy settings for the scraper	{...}

Output Example

Each result contains structured data like this:

{
  "movie_title": "Sample movie_title",
  "year": 2024,
  "director": "Sample director",
  "average_rating": 4.5,
  "watch_count": 127,
  "genres": "Sample genres",
  "runtime": "Sample runtime",
  "letterboxd_url": "https://example.com/item"
}

Pricing

This actor uses pay-per-result pricing:

• $0.001 per result
• $1.00 per 1,000 results

No monthly fees. You only pay for what you scrape. Apify Free plan includes $5/month in platform credits.

How to Run

Apify Console

1. Go to the Letterboxd Movies, Reviews & Ratings Scraper actor page
2. Configure your input parameters
3. Click Start and wait for the results
4. Download data in JSON, CSV, or Excel format

API

curl -X POST "https://api.apify.com/v2/acts/fortuitous_pirate~letterboxd-movies-reviews-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 10}'

Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("fortuitous_pirate/letterboxd-movies-reviews-scraper").call(
    run_input={"maxItems": 10}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Integration

Connect Letterboxd Movies, Reviews & Ratings Scraper with your existing tools and workflows:

• API access - Programmatic access via Apify API
• Webhooks - Get notified when scraping completes
• Scheduling - Set up recurring runs on any schedule
• Zapier / Make - Connect with 5,000+ apps via Apify integrations
• Python / Node.js SDKs - Native client libraries for easy integration