Letterboxd Film Reviews Scraper

This actor scrapes film reviews from Letterboxd.com by URL. You provide a film reviews page URL (e.g. a film’s “reviews by activity” page). It follows pagination and extracts reviewer, rating, date, review text, and engagement (likes, comments).

Features

• URL-based: Provide a Letterboxd film reviews page URL to scrape.
• Pagination: Follows “Next” through all pages until the end or the max items limit.
• Review data: For each review you get reviewer name and profile, star rating, watched/rewatched, date, review text, likes count, comment count, and links.

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Full Letterboxd film reviews page URL to scrape
maxItems	integer	No	Maximum number of reviews to fetch

Output

A list of review objects. Each object includes:

• searchUrl: The input URL used.
• reviewId: Unique id for the review (e.g. viewing:123).
• userProfileUrl: Reviewer’s Letterboxd profile URL.
• userAvatarUrl: Reviewer’s avatar image URL.
• userDisplayName: Reviewer’s display name.
• ratingStars: Star rating text (e.g. ★★★), if present.
• watchedType: "Watched" or "Rewatched".
• reviewDate: Date of the review (ISO-style from page).
• commentCount: Number of comments, if shown.
• reviewText: Review body text (visible/collapsed portion).
• fullTextUrl: URL to full review text, if available.
• likesCount: Number of likes.
• reviewUrl: Link to the review/film page for that user.
• scrapedAt: When the item was scraped.

Example:

[
  {
    "searchUrl": "https://letterboxd.com/film/war/reviews/by/activity/",
    "reviewId": "viewing:339959152",
    "userProfileUrl": "https://letterboxd.com/mrmoviesrd/",
    "userAvatarUrl": "https://a.ltrbxd.com/resized/avatar/upload/1/0/4/8/5/7/2/shard/avtr-0-80-0-80-crop.jpg?v=82076f60ee",
    "userDisplayName": "Rafael \"Mister Movie\" Jovine",
    "ratingStars": "★★★",
    "watchedType": "Watched",
    "reviewDate": "2023-01-15",
    "commentCount": "8",
    "reviewText": "Statham and Li reteam for another film...",
    "fullTextUrl": "https://letterboxd.com/s/full-text/viewing:339959152/",
    "likesCount": 138,
    "reviewUrl": "https://letterboxd.com/mrmoviesrd/film/war/",
    "scrapedAt": "2025-02-06T12:00:00.000Z"
  }
]

Use Cases

• Film review aggregation and analysis
• Sentiment or rating research for movies
• Sourcing quotes and reviews for articles or apps