Letterboxd API

Letterboxd Scraper API for Films, Ratings, Diaries, Reviews and Lists

Look up Letterboxd films with ratings, cast, crew, releases, popular reviews and IMDb and TMDB IDs, list a director’s or actor’s filmography, and read a member’s profile, activity, diary, watched films, watchlist, reviews, lists and network.

Gibran Pulga, CEO of Desys FinanceGibran PulgaCEO, Desys Finance

We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

WHAT YOU CAN BUILD / 10 ENDPOINTS

Put Letterboxd data to work.

Find your use case, then explore the request and response.

Get a Letterboxd film

GET/v1/letterboxd/film

Build a film page from a Letterboxd slug, URL or boxd.it link with the average rating, rating and review counts, cast with characters, crew, studios, countries, languages, genres, themes, releases, popular reviews, similar films and IMDb and TMDB IDs.

Get a Letterboxd filmography

GET/v1/letterboxd/person

Build a filmmaker or actor page from a Letterboxd slug or URL with the biography, portrait, TMDB ID, every credited role with its film count and the films in the selected role.

Get a Letterboxd profile

GET/v1/letterboxd/profile

Build a member card from a username with the display name, avatar, bio, location, website, four favorite films and the all-time stats when the member shares them.

List a Letterboxd member's activity

GET/v1/letterboxd/user-feed

Build an activity feed from a username with the latest diary entries, full-text reviews and lists, including ratings, likes, rewatches, watched dates and TMDB IDs.

List a Letterboxd member's diary

GET/v1/letterboxd/user-diary

Build a viewing log from a username with each diary entry’s watched date, film, rating, like, rewatch and review flags.

List a Letterboxd member's watched films

GET/v1/letterboxd/user-films

Build a watched-films grid from a username with each film’s member rating, like and review link.

List a Letterboxd member's watchlist

GET/v1/letterboxd/user-watchlist

Build a recommendations input from a member’s watchlist with the films most recently added and the watchlist’s total size.

List a Letterboxd member's reviews

GET/v1/letterboxd/user-reviews

Build a review analysis set from a member’s reviews with film, rating, like, rewatch, watched date, spoiler flag, text, likes and comments.

List a Letterboxd member's lists

GET/v1/letterboxd/user-lists

Build a list directory from a member’s lists with names, film counts, likes, comments, notes and preview films.

List a Letterboxd member's network

GET/v1/letterboxd/user-connections

Build a follower graph from a member’s following or followers with display names, avatars and their own follower and following counts.

HOW IT WORKS

From API key to Letterboxd data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 10 Letterboxd endpoints and add its input, such as a public URL.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Letterboxd data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

LIVE RESULTS

Try a sample request.

Try the Letterboxd API right here. This sample uses the Get a Letterboxd film endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with https://letterboxd.com/film/the-room/, or change the url field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Letterboxd filmNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "https://letterboxd.com/film/the-room/";
const url = new URL("/website/demo/letterboxd",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/letterboxd/film

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

  • Matteo L.Small-Business (50 or fewer emp.)

    “Easy, Affordable Scraping for Product Ideas—More Platforms Needed”

    I use ScrapeAtlas to find product ideas—real ideas that people need. I couldn’t get to people’s ideas on social media platforms without it. I like that it’s easy and capable, and it isn’t expensive. I value the scraping and MCP features. …

    Read on G2
  • Ms H.Sales, Mid-Market (51-1000 emp.)

    “ScrapeAtlas Replaces Multiple Scrapers with One Simple Solution”

    ScrapeAtlas saves me from juggling a different scraper for every platform. … ScrapeAtlas solves the problem of getting reliable public data from many social and e-commerce platforms without building and maintaining my own scrapers.

    Read on G2
  • We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

    Gibran PulgaCEO, Desys Finance
  • Stas D.Founder, Marketing and Advertising

    “Reliable parsers and flexible API for audience search”

    I like the convenient documentation and conditions at ScrapeAtlas. The parsers work great: I use keyword data from fresh threads to find target audiences and clients in Threads. I also appreciate the higher quality API responses and more detailed request customization. The initial setup was very easy for me.

    Read on G2

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 credits

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 credits

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 credits

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Letterboxd API

Frequently Asked Questions

Explore the API reference

Letterboxd API and scraping

What Letterboxd data can I retrieve with the ScrapeAtlas API?

Retrieve public Letterboxd films, filmographies, member profiles, activity feeds, diaries, watched films, watchlists, reviews, lists and networks as structured JSON. Films include the average rating, rating and review counts, cast, crew, genres, themes, releases, popular reviews and IMDb and TMDB IDs.

Which fields does a Letterboxd film return?

Send a film slug such as parasite-2019, a letterboxd.com film URL or a boxd.it link to Get a Letterboxd film. The response returns the title, original title, year, release date, runtime, tagline, synopsis, poster, backdrop, trailer, average rating with rating and review counts, directors, cast with characters, crew by role, studios, countries, languages, genres, themes, releases by country, popular reviews, similar films and IMDb and TMDB IDs.

Can I get a film’s Letterboxd rating and review count?

Yes. Get a Letterboxd film returns rating.average (the weighted average from 0.5 to 5 stars), rating.count and rating.reviewCount, or null when the film has too few ratings. Member endpoints return each member’s own rating in stars.

Letterboxd: films, diaries, reviews and lists

How do I read a member’s Letterboxd diary and activity?

Send a username to List a Letterboxd member’s diary for the latest entries with watched date, film, rating, like, rewatch and review flags. List a Letterboxd member’s activity returns the latest diary entries, full-text reviews and lists in one feed.

Can I collect Letterboxd reviews with ratings and text?

Yes. List a Letterboxd member’s reviews returns each review’s film, rating, like, rewatch, watched date, spoiler flag, text, likes and comments. Get a Letterboxd film includes the film’s most popular reviews with the reviewer, and the activity feed carries the member’s latest reviews in full.

How do I get a Letterboxd member’s watchlist, lists and followers?

Use List a Letterboxd member’s watchlist for the most recently added films and the watchlist size, List a Letterboxd member’s lists for list names, film counts, likes and preview films, and List a Letterboxd member’s network with type following or followers.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?