Get a Letterboxd film
Get a film by slug, letterboxd.com URL or boxd.it short link, with its average rating and counts, cast with characters, crew, studios, countries, languages, genres, themes, releases, popular reviews, similar films and IMDb and TMDB IDs.
/v1/letterboxd/filmx-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
Film slug, as in letterboxd.com/film/<slug>/ (films without a text slug use film:<id>). Provide exactly one of slug or url.
max 200 chars
parasite-2019A letterboxd.com film URL (any film sub-page) or a boxd.it short link to a film.
max 1024 chars
True when usable data is returned; inspect status and coverage.
success or partial for usable data; failed or challenged for a failure.
one of: success, partial
Request correlation UUID.
Public letterboxd.com page the data describes.
absolute HTTPS URL
UTC retrieval timestamp.
Returned-page coverage and mapping warnings.
Letterboxd's public website.
Whether every supported field was mapped without a reported omission.
Named warnings: first_page_only (the member has more pages than the first one returned), invalid_item (an entry without an ID, film or name was skipped), record_limit (a list was capped), field_unavailable (the page had no structured data block, or a film's credit or detail panels were missing or unmappable) or stats_unavailable (the member's stats page could not be read or mapped; members without public stats return stats null with no warning).
Retrieval attempt, source byte and timing measurements.
Upstream request attempts, including any retry.
≥ 0
Decoded source bytes read during this request.
≥ 0
Elapsed operation time in milliseconds.
≥ 0
Film details.
Letterboxd numeric film ID, or null.
≥ 0
Letterboxd short ID, or null.
Current film slug.
Public letterboxd.com film page.
absolute HTTPS URL
boxd.it short link, or null.
absolute HTTPS URL
Film title.
Original-language title when it differs, or null.
Release year, or null.
≥ 0
First release date (YYYY-MM-DD), or null.
Runtime in minutes, or null.
≥ 0
Tagline, or null.
Synopsis, or null.
Poster image URL, or null.
absolute HTTPS URL
Backdrop image URL, or null.
absolute HTTPS URL
YouTube trailer URL, or null.
absolute HTTPS URL
IMDb title ID (tt…), or null.
TMDB ID, or null.
≥ 0
TMDB record type, for example movie or tv, or null.
Letterboxd member rating summary.
Weighted average rating from 0.5 to 5, or null when there are too few ratings.
0 – 5
Number of member ratings, or null.
≥ 0
Number of member reviews, or null.
≥ 0
Directors.
up to 50 items
Always included.
Always included.
Always included.
absolute HTTPS URL
Cast in billing order.
up to 100 items
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
Crew members by role.
up to 200 items
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
Production studios.
up to 50 items
Always included.
Always included.
Always included.
absolute HTTPS URL
Production countries.
up to 50 items
Always included.
Always included.
Primary languages.
up to 50 items
Always included.
Always included.
Spoken languages.
up to 50 items
Always included.
Always included.
Alternative and translated titles, split on ", ".
up to 100 items
The alternative titles exactly as Letterboxd prints them (comma-separated), or null; alternativeTitles splits this text on ", ".
Genres.
up to 50 items
Always included.
Always included.
Themes and mini-themes.
up to 50 items
Always included.
Always included.
Release dates by type and country.
up to 200 items
Always included.
Always included.
Always included.
Always included.
Always included.
The film's most popular reviews.
up to 12 items
Always included.
Always included.
absolute HTTPS URL
Always included.
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
absolute HTTPS URL
Always included.
0.5 – 5
Always included.
Always included.
Always included.
Always included.
Always included.
≥ 0
Always included.
≥ 0
Similar films Letterboxd recommends.
up to 12 items
Always included.
≥ 0
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
Always included.
≥ 0
No fields match.
HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.
| HTTP | failure.code | Meaning |
|---|---|---|
| 200 | partial | Usable data with named first-page, invalid-item, record-limit, field or stats warnings. |
| 400 | invalid_request | Missing, duplicate, malformed or unsupported parameters. |
| 401 | unauthorized | Missing or invalid worker API key. |
| 404 | not_found | The requested Letterboxd film, person or member was not found. |
| 403 | restricted_page | The member keeps the requested page, such as a watchlist, private. |
| 422 | unsupported_page | The Letterboxd page structure or identity could not be mapped. |
| 502 | upstream_challenged | Letterboxd challenged retrieval. |
| 502 | upstream_rate_limited | Letterboxd rate-limited retrieval. |
| 502 | upstream_error | Source retrieval did not complete. |
| 502 | response_too_large | Decoded source bytes exceeded the request limit. |
| 502 | unsafe_redirect | Letterboxd redirected outside the requested page. |
| 502 | request_limit | The upstream request budget was exhausted. |
| 503 | busy | Worker request or queue capacity was exceeded. |
| 504 | timeout | The operation deadline expired. |