API Reference
Use Crawlora's Letterboxd API endpoints to extract supported public Letterboxd data as structured JSON. This documentation covers 8 active endpoints including Get a Letterboxd film, Get a Letterboxd film's rating distribution, Get a Letterboxd film's popular reviews, Get films similar to a Letterboxd film, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as slug, username, q, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/letterboxd/search?q=coffee&type=film&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/letterboxd/film/{slug}apiKey3 credits/requestReturns a normalized Letterboxd film: synopsis, director, cast, genres, countries, languages, runtime, and aggregate member rating. Credential-free public Letterboxd data (letterboxd.com), parsed from the film page's schema.org structured data.
Required params: slug:path
/letterboxd/film/{slug}/rating-histogramapiKey1 credit/requestReturns a film's full star-rating distribution (0.5 to 5.0 in half-star buckets) with counts and percentages. Credential-free public Letterboxd data.
Required params: slug:path
/letterboxd/film/{slug}/reviewsapiKey2 credits/requestReturns a film's popular reviews (reviewer, rating, date, text, like/comment counts, spoiler flag). Credential-free public Letterboxd data.
Required params: slug:path
/letterboxd/film/{slug}/similarapiKey2 credits/requestReturns films Letterboxd recommends as similar to the given film. Credential-free public Letterboxd data.
Required params: slug:path
/letterboxd/member/{username}apiKey1 credit/requestReturns a member's public profile stats (films watched, lists, following/followers). No private data — everything is visible to a logged-out visitor. Credential-free public Letterboxd data.
Required params: username:path
/letterboxd/person/{slug}apiKey2 credits/requestReturns a person's Letterboxd filmography for a credit role. Credential-free public Letterboxd data.
Required params: slug:path
/letterboxd/popularapiKey2 credits/requestReturns a popularity-ranked film chart, optionally scoped to a time window, genre, and/or decade. Credential-free public Letterboxd data.
Required params: None
/letterboxd/searchapiKey2 credits/requestSearches Letterboxd films, people, lists, and tags. Credential-free public Letterboxd data.
Required params: q:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get a Letterboxd film | /letterboxd/film/{slug} | GET | 3 credits/request | slug:path | View docs | Try endpoint |
| Get a Letterboxd film's rating distribution | /letterboxd/film/{slug}/rating-histogram | GET | 1 credit/request | slug:path | View docs | Try endpoint |
| Get a Letterboxd film's popular reviews | /letterboxd/film/{slug}/reviews | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get films similar to a Letterboxd film | /letterboxd/film/{slug}/similar | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get a Letterboxd member's public profile stats | /letterboxd/member/{username} | GET | 1 credit/request | username:path | View docs | Try endpoint |
| Get a Letterboxd person's filmography | /letterboxd/person/{slug} | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get a Letterboxd popularity-ranked film chart | /letterboxd/popular | GET | 2 credits/request | None | View docs | Try endpoint |
| Search Letterboxd | /letterboxd/search | GET | 2 credits/request | q:query | View docs | Try endpoint |