Skip to content
scrapeatlas.Dashboard

Get a Letterboxd film

Try in Playground

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.

GET/v1/letterboxd/filmx-api-key
x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters
2
slugstringquery

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

Exampleparasite-2019
urlstringquery

A letterboxd.com film URL (any film sub-page) or a boxd.it short link to a film.

max 1024 chars

Response fields
99
successboolean

True when usable data is returned; inspect status and coverage.

statusenum

success or partial for usable data; failed or challenged for a failure.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Public letterboxd.com page the data describes.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Returned-page coverage and mapping warnings.

coverage.sourcestring

Letterboxd's public website.

coverage.completeboolean

Whether every supported field was mapped without a reported omission.

coverage.warningsenum[]

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.

accounting.upstreamRequestsinteger

Upstream request attempts, including any retry.

≥ 0

accounting.responseBytesinteger

Decoded source bytes read during this request.

≥ 0

accounting.durationMsnumber

Elapsed operation time in milliseconds.

≥ 0

Film details.

film.idintegernullable

Letterboxd numeric film ID, or null.

≥ 0

film.lidstringnullable

Letterboxd short ID, or null.

film.slugstring

Current film slug.

film.urlstring

Public letterboxd.com film page.

absolute HTTPS URL

film.shortUrlstringnullable

boxd.it short link, or null.

absolute HTTPS URL

film.namestring

Film title.

film.originalNamestringnullable

Original-language title when it differs, or null.

film.yearintegernullable

Release year, or null.

≥ 0

film.releaseDatestringnullable

First release date (YYYY-MM-DD), or null.

film.runtimeMinutesintegernullable

Runtime in minutes, or null.

≥ 0

film.taglinestringnullable

Tagline, or null.

film.synopsisstringnullable

Synopsis, or null.

film.posterUrlstringnullable

Poster image URL, or null.

absolute HTTPS URL

film.backdropUrlstringnullable

Backdrop image URL, or null.

absolute HTTPS URL

film.trailerUrlstringnullable

YouTube trailer URL, or null.

absolute HTTPS URL

film.imdbIdstringnullable

IMDb title ID (tt…), or null.

film.tmdbIdintegernullable

TMDB ID, or null.

≥ 0

film.tmdbTypestringnullable

TMDB record type, for example movie or tv, or null.

Letterboxd member rating summary.

film.rating.averagenumbernullable

Weighted average rating from 0.5 to 5, or null when there are too few ratings.

0 – 5

film.rating.countintegernullable

Number of member ratings, or null.

≥ 0

film.rating.reviewCountintegernullable

Number of member reviews, or null.

≥ 0

Directors.

up to 50 items

film.directors.namestring

Always included.

film.directors.slugstring

Always included.

film.directors.urlstring

Always included.

absolute HTTPS URL

Cast in billing order.

up to 100 items

film.cast.namestring

Always included.

film.cast.slugstring

Always included.

film.cast.urlstring

Always included.

absolute HTTPS URL

film.cast.characterstringnullable

Always included.

Crew members by role.

up to 200 items

film.crew.namestring

Always included.

film.crew.slugstring

Always included.

film.crew.urlstring

Always included.

absolute HTTPS URL

film.crew.rolestring

Always included.

Production studios.

up to 50 items

film.studios.namestring

Always included.

film.studios.slugstring

Always included.

film.studios.urlstring

Always included.

absolute HTTPS URL

Production countries.

up to 50 items

film.countries.namestring

Always included.

film.countries.slugstring

Always included.

Primary languages.

up to 50 items

film.primaryLanguages.namestring

Always included.

film.primaryLanguages.slugstring

Always included.

Spoken languages.

up to 50 items

film.spokenLanguages.namestring

Always included.

film.spokenLanguages.slugstring

Always included.

film.alternativeTitlesstring[]

Alternative and translated titles, split on ", ".

up to 100 items

film.alternativeTitlesTextstringnullable

The alternative titles exactly as Letterboxd prints them (comma-separated), or null; alternativeTitles splits this text on ", ".

Genres.

up to 50 items

film.genres.namestring

Always included.

film.genres.slugstring

Always included.

Themes and mini-themes.

up to 50 items

film.themes.namestring

Always included.

film.themes.slugstring

Always included.

Release dates by type and country.

up to 200 items

film.releases.typestring

Always included.

film.releases.datestringnullable

Always included.

film.releases.countrystring

Always included.

film.releases.certificationstringnullable

Always included.

film.releases.notestringnullable

Always included.

The film's most popular reviews.

up to 12 items

film.popularReviews.idstring

Always included.

film.popularReviews.urlstringnullable

Always included.

absolute HTTPS URL

Always included.

film.popularReviews.author.usernamestring

Always included.

film.popularReviews.author.displayNamestringnullable

Always included.

film.popularReviews.author.urlstring

Always included.

absolute HTTPS URL

film.popularReviews.author.avatarUrlstringnullable

Always included.

absolute HTTPS URL

film.popularReviews.ratingnumbernullable

Always included.

0.5 – 5

film.popularReviews.likedbooleannullable

Always included.

film.popularReviews.spoilerboolean

Always included.

film.popularReviews.textstringnullable

Always included.

film.popularReviews.textTruncatedboolean

Always included.

film.popularReviews.likeCountintegernullable

Always included.

≥ 0

film.popularReviews.commentCountintegernullable

Always included.

≥ 0

Similar films Letterboxd recommends.

up to 12 items

film.similarFilms.idintegernullable

Always included.

≥ 0

film.similarFilms.lidstringnullable

Always included.

film.similarFilms.slugstring

Always included.

film.similarFilms.urlstring

Always included.

absolute HTTPS URL

film.similarFilms.namestring

Always included.

film.similarFilms.yearintegernullable

Always included.

≥ 0

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.

Error codes
14
HTTPfailure.codeMeaning
200partialUsable data with named first-page, invalid-item, record-limit, field or stats warnings.
400invalid_requestMissing, duplicate, malformed or unsupported parameters.
401unauthorizedMissing or invalid worker API key.
404not_foundThe requested Letterboxd film, person or member was not found.
403restricted_pageThe member keeps the requested page, such as a watchlist, private.
422unsupported_pageThe Letterboxd page structure or identity could not be mapped.
502upstream_challengedLetterboxd challenged retrieval.
502upstream_rate_limitedLetterboxd rate-limited retrieval.
502upstream_errorSource retrieval did not complete.
502response_too_largeDecoded source bytes exceeded the request limit.
502unsafe_redirectLetterboxd redirected outside the requested page.
502request_limitThe upstream request budget was exhausted.
503busyWorker request or queue capacity was exceeded.
504timeoutThe operation deadline expired.