Letterboxd Scraper

Extract film metadata, user film lists, tags, and search results from Letterboxd.

What does Letterboxd Scraper do?

Scrape structured data from Letterboxd in four modes:

• Film details — pass film URLs, get title, year, runtime, rating, cast, crew, genres, poster, and external links (TMDb, IMDb).
• User films — pass usernames, get their public film list: every film they've watched. 72 films per page, auto-paginated.
• Tags — pass tags, get every film carrying that tag. 72 films per page, auto-paginated.
• Search — pass keywords, get matching films via Letterboxd's mobile API. Returns slug, title, and URL. Up to 10,000 results per term.

Film pages and user/tag lists are server-rendered. Search uses Letterboxd's anonymous mobile API endpoint — no login, no browser.

Output fields

Film mode

Field	Description
slug	Letterboxd film slug
title	Film title
year	Release year
runtime	Runtime in minutes
rating	Average user rating (0–5)
ratingCount	Number of ratings
directors	Array of director names
cast	Array of cast names
genres	Array of genres
tagline	Marketing tagline
description	Synopsis
poster	Poster image URL
tmdbLink	TMDb URL
imdbLink	IMDb URL
letterboxdUrl	Direct URL to film page

User films / Tags / Search modes

Field	Description
type	user, tag, or search
source	Username, tag, or search term
slug	Letterboxd film slug
title	Film title (with year where available)
letterboxdUrl	Direct URL to film page

Who is it for?

• Film researchers building datasets of films, directors, and ratings
• Cinephile communities tracking what members have watched
• Data scientists building recommendation models on Letterboxd ratings
• Journalists monitoring film discourse and rating trends
• Developers integrating film metadata into apps

Pricing

$0.0012 per result ($1.20 per 1,000 items). No subscription.

Results	Cost
100	$0.12
1,000	$1.20
10,000	$12.00

How to use it

1. Paste Film URLs for detailed metadata, or
2. Enter Usernames for public film lists, or
3. Add Tags for genre/theme collections, or
4. Add Search Terms to find films by keyword.
5. Set Max Items per Source (default 500) and Max Pages per Source (default 3).
6. Click Start.

Output example

{
  "type": "film",
  "slug": "parasite-2019",
  "title": "Parasite",
  "year": 2019,
  "runtime": 132,
  "rating": 4.34,
  "ratingCount": 892341,
  "directors": ["Bong Joon-ho"],
  "cast": ["Song Kang-ho", "Lee Sun-kyun", "Cho Yeo-jeong"],
  "genres": ["Thriller", "Drama", "Comedy"],
  "tagline": "Act like you own the place.",
  "description": "All unemployed, Ki-taek's family takes peculiar interest in the wealthy and glamorous Parks...",
  "poster": "https://a.ltrbxd.com/resized/film-poster/...",
  "tmdbLink": "https://www.themoviedb.org/movie/496243",
  "imdbLink": "https://www.imdb.com/title/tt6751668",
  "letterboxdUrl": "https://letterboxd.com/film/parasite-2019/",
  "scrapedAt": "2026-09-20T10:00:00.000Z"
}

Technical details

• Built with Cheerio + got-scraping (TLS impersonation) for film pages, user lists, and tags.
• Search uses Letterboxd's anonymous mobile API (api.letterboxd.com/api/v0/search) — pure JSON, cursor-paginated.
• Chrome-realistic headers, retry with exponential backoff on 403/429/5xx.
• Residential proxy is recommended for user film list pagination — Cloudflare rate-limits datacenter IPs after the first page.
• No API key or login required.

Known limits

• Letterboxd has no official public API. This Actor extracts from public HTML and the mobile API endpoint.
• User film lists are capped by maxPagesPerSource. Each page holds 72 films; Letterboxd may rate-limit rapid pagination.
• Search returns slug + title only, not full metadata. Chain it with film mode by passing result URLs as filmUrls.
• Private profiles and private lists are not accessible.

FAQ

Do I need a proxy? Film pages and search work without one. User film lists benefit from residential proxy to avoid Cloudflare rate-limits on pagination.

Can I scrape private profiles? No. Only public profiles and public data.

Does this include reviews or diaries? No. This Actor extracts film lists (watched films), not the diary or review text.

How do I export data? After a run, go to Storage → Export as JSON, CSV, Excel.

Support

Open an issue on the Actor's page for bugs or feature requests.