Letterboxd API

Letterboxd films, ratings, reviews, lists and member profiles as clean JSON.

The API.SH Letterboxd API turns public Letterboxd pages into structured JSON. Look up a film with cast, crew, genres, releases, average rating and popular reviews, page through member reviews and the lists a film appears on, search films, lists, cast and crew or members, and read a member's public profile.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Letterboxd search

GET https://api.api.sh/letterboxd/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Letterboxd API

Film metadata and ratings

Get a film's average rating, cast, crew, genres, themes, releases and IMDb and TMDB ids, with watch and list counts on request.

/film

Review analysis

Page through member reviews sorted by popularity, date or rating, with star rating, spoiler and rewatch flags, likes and comments.

/reviews

List and curation research

Find the member lists that include a film, with owner, film count, likes and the first films on each list.

/lists

Taste and member profiles

Read a member's stats, rating histogram, favorite films, recent activity and latest diary entries.

/user

Film search for apps and agents

Search films, lists, cast and crew or members and hand the slug to a recommendation app or AI agent.

/search /film

Letterboxd data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Letterboxd API endpoints and prices

Every Letterboxd endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Letterboxd search

/letterboxd/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

Letterboxd member profile

/letterboxd/v1/user

$1 · $2 PAYG

1 credit

Comments and reviews1

Letterboxd film reviews

/letterboxd/v1/reviews

$1 · $2 PAYG

1 credit

More data2

Letterboxd film /letterboxd/v1/film	$1 · $2 PAYG 1 credit
Letterboxd lists with a film /letterboxd/v1/lists	$1 · $2 PAYG 1 credit

Call the Letterboxd API

Letterboxd search: GET https://api.api.sh/letterboxd/v1/search

curl "https://api.api.sh/letterboxd/v1/search?q=parasite" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/letterboxd/v1/search",
    params={"q": "parasite"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/letterboxd/v1/search");
url.searchParams.set("q", "parasite");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/letterboxd/v1/search", "q", "parasite")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Letterboxd" and "Letterboxd search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Letterboxd data

Public data only: no Letterboxd login, cookies or account needed
One key and one response shape for Letterboxd and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Letterboxd API

Letterboxd's own API is available by request only, so most developers cannot get a key. API.SH needs no request or approval and returns public film, review, list and profile data in one JSON format.

Rather than keeping a GitHub scraper alive or exporting pages by hand, use one API.SH key with a fixed price per call.

Letterboxd API questions

What Letterboxd data can I get?+

Film details (/letterboxd/v1/film), member reviews (/letterboxd/v1/reviews), lists that include a film (/letterboxd/v1/lists), search for films, lists, cast and crew or members (/letterboxd/v1/search) and public member profiles (/letterboxd/v1/user).

How much does the Letterboxd API cost?+

Every Letterboxd endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /letterboxd/v1/film at 1 credit each.

Does Letterboxd have an official API?+

Yes, but its API page says access is by request only. API.SH is a separate service that needs no Letterboxd approval and reads public pages.

Do I need a Letterboxd account or login?+

No. API.SH reads public Letterboxd pages only. No endpoint uses a login, cookies or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /letterboxd/v1/film with the slug of a film or its Letterboxd url. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Can I get a member's watchlist or diary?+

Not a full watchlist. /letterboxd/v1/user returns the public profile: stats, ratings count and histogram, favorite films, recent activity, diary count and the latest diary entries, plus pinned and recent lists.

Can I use it from Python?+

Yes. Call any route with requests or another HTTP client, or use the API.SH Python SDK. Search with /letterboxd/v1/search, then pass a film slug to /letterboxd/v1/film or /letterboxd/v1/reviews.