npm.io
1.0.0 • Published 3d ago

letterboxd-film-review-scraper

Licence
MIT
Version
1.0.0
Deps
1
Size
7 kB
Vulns
0
Weekly
0

Letterboxd Film & Review Scraper

Run on Apify Node.js client

Letterboxd Film & Review Scraper — a Node.js client for the Apify Actor. Pull Letterboxd Film & Review data at scale with no API-key hassle: thousands of clean, structured results you can export to JSON, CSV or Excel.

Run it on Apify: https://apify.com/logiover/letterboxd-film-review-scraper

Install

npm install letterboxd-film-review-scraper

Usage

const scrape = require("letterboxd-film-review-scraper");

(async () => {
  const items = await scrape({}, { token: process.env.APIFY_TOKEN });
  console.log(items.length, "results");
  console.log(items[0]);
})();

Get your free Apify token at https://console.apify.com/account/integrations.

Input

Field Type Description
mode string Scrape Mode
startUrls array Letterboxd URLs
searchQueries array Search Keywords
filmSort string Popular Films — Sort / Period
scrapeReviews boolean Scrape Reviews
fetchFullText boolean Fetch Full Review Text
maxReviews integer Max Reviews Per Film
maxFilms integer Max Films
proxyConfiguration object Proxy Settings

All fields optional — run with empty input {} for a broad default result set.

Output

Each result item includes fields such as: title, year, director, averageRating, ratingsCount, genres, runtime, filmUrl, posterUrl, scrapedAt, filmTitle, filmYear, reviewer, username, rating, reviewText, isSpoiler, likes, reviewDate, reviewUrl.

Why use this

  • Thousands of results per run, auto-paginated
  • No Letterboxd Film & Review login or reverse-engineering — just call the Actor
  • Export to JSON, CSV, Excel, JSONL, XML
  • Runs on Apify cloud — schedule it, add webhooks, wire into Make / Zapier / n8n

FAQ

Do I need an API key?

Only a free Apify token (grab one at https://console.apify.com/account/integrations). No Letterboxd Film & Review login and no scraping setup on your side.

How many results can I get?

Thousands per run. Raise the limit in the input to pull more — the Actor paginates for you.

What export formats are supported?

Results are plain JSON in code; from the Apify dataset you can export CSV, Excel, JSON, JSONL or XML.

Is this an official Letterboxd Film & Review API?

No. It is an unofficial Letterboxd Film & Review data client on the Apify platform — a maintained alternative when there is no official or affordable API.


MIT 2026 logiover · Client library for the hosted Apify Actor. Not affiliated with Letterboxd Film & Review.

Keywords