Sign in Get API key
Letterboxd API

Letterboxd API for Film Details, Reviews, and User Diary

Scrappa's Letterboxd API returns structured JSON from Letterboxd, the social film discovery platform. Retrieve film details with ratings, histograms and stats, and fetch user diary entries. Scrappa is an independent service and is not affiliated with or endorsed by Letterboxd.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
2
Endpoints
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/letterboxd/film?slug=the-dark-knight" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "title": "The Dark Knight",
    "year": 2008,
    "directors": ["Christopher Nolan"],
    "average_rating": 4.5,
    "poster": "https://a.ltrbxd.com/resized/film-poster.jpg",
    "film_id": "{\"lid\":\"2b0k\",\"uid\":\"film:51896\"}",
    "rating_histogram": {"0.5": 2979, "5.0": 2400000},
    "watched_count": 7029205,
    "lists_count": 1047116,
    "likes_count": 3072423
  },
  "meta": {"endpoint_family": "film_detail", "billable": true}
}

What you can build

Structured data for real applications. Here are some ideas.

Film Data Aggregation

Retrieve film details with average rating, rating histogram, watched count, lists count and likes count for any Letterboxd film.

Review Analysis

Read public film reviews with text, author and date for sentiment analysis and audience research.

User Activity Tracking

Fetch public user profiles with films watched and diary entries to track viewing habits.

Film Discovery

Search the Letterboxd film database by query and retrieve structured results with directors.

Available endpoints

Everything you need in one API.

Scrappa vs Letterboxd API v0

See how Scrappa compares to the official API.

Film Details
Scrappa: $0.20/1k
Letterboxd API v0: OAuth required
Reviews
Scrappa:
Letterboxd API v0: members only
User Profiles
Scrappa:
Letterboxd API v0: members only
Diary
Scrappa:
Letterboxd API v0:
Search
Scrappa:
Letterboxd API v0:
Authentication
Scrappa: API key
Letterboxd API v0: OAuth 2.0
Free tier
Scrappa: 500 credits/month
Letterboxd API v0: none
Billing setup
Scrappa:
Letterboxd API v0:

Key features

Film details with average rating, histogram, and stats
Film reviews with text, author, and date
User profiles with films watched count
User diary entries with pagination
Film search with directors
No Letterboxd account required
Proxy-first scraping for reliability

Frequently asked questions

You can retrieve film details (title, year, directors, average rating, rating histogram, watched count, lists count, likes count, poster), film reviews with pagination, user profiles, user diary entries with pagination, and search results.

No. All endpoints access public Letterboxd data. No login or account cookies are required.

Successful requests are billable. Failed requests (upstream errors, invalid slugs, blocked content) are not billable. You only pay for data you receive.

Start using the Letterboxd API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation