Get Letterboxd film
Get a Letterboxd film's identity, synopsis, cast, crew, releases, rating, similar films and popular reviews.
Headers
Get your API keyAPI key (`sfk_...`)
Letterboxd film slug: letters, digits and hyphens, e.g. `parasite-2019`. Input is lowercased. Required, no default; 1 to 200 characters.
min 1 chars · max 200 chars
Endpoint-specific response payload.
`not_found` when the film does not exist or was deleted.
one of: found, not_found
The film's canonical URL, or null when not found.
The film when `lookupStatus` is `found`; otherwise null.
Numeric film id.
Film slug.
Short code for `boxd.it`.
Derived short link.
Title.
Release year.
Whether the entry is a film or a TV title.
one of: movie, tv, null
Original title when it differs from the title.
Language code of the original title, when shown.
Tagline.
Synopsis.
Runtime in minutes; for a TV title, the total shown.
TMDB identity.
TMDB id.
TMDB kind.
one of: movie, tv, null
IMDb id.
Directors.
Name.
Slug used in the person or studio URL.
Cast with character names.
Name.
Slug used in the person or studio URL.
Character name, or null when not shown.
Crew grouped by department.
Department name.
People in the department.
Name.
Slug used in the person or studio URL.
Production studios.
Name.
Slug used in the person or studio URL.
Countries of origin.
Name.
Slug used in the person or studio URL.
Primary language.
Name.
Slug used in the person or studio URL.
Spoken languages. When only one language is listed, that language is mirrored here; an empty array means no spoken language is listed (for example a silent film).
Name.
Slug used in the person or studio URL.
Alternative titles.
Genres.
Themes.
Theme name.
Whether it is a theme or a mini-theme.
one of: theme, mini_theme
Every release shown, with date, country, type and certification.
Release date as ISO 8601 (`YYYY-MM-DD`), or null.
Country of the release.
Release type, e.g. `Premiere` or `Theatrical`.
Certification shown for this release, or null.
Festival or other note shown with the release, or null.
Poster URL, passed through.
Backdrop URL, passed through.
Embedded trailer, or null.
YouTube video id of the trailer.
Aggregate rating; null for an unreleased title.
Average rating, 0.5 to 5.
Number of ratings.
Number of reviews.
Highest rating in the scale.
Lowest rating in the scale.
Similar films.
Film slug, e.g. `parasite-2019`.
Numeric film id.
Short code used by `https://boxd.it/{shortCode}`.
Derived short link; null when the short code was not shown.
Title.
Release year, when shown.
The popular reviews returned with the film.
Viewing id.
Who wrote the review; null when the card does not name them.
Username in lowercase form.
Display name.
The author's rating, or null.
Likes on the review.
Comments on the review; 0 when the card shows a like control but no comment link, null when the card shows neither.
Whether the review is marked as containing spoilers.
The review text.
Whether the review text is only the opening part.
The viewing date (`Watched`), ISO 8601 date, when shown.
The reviewed film; null on cards that do not repeat it.
Film slug, e.g. `parasite-2019`.
Numeric film id.
Short code used by `https://boxd.it/{shortCode}`.
Derived short link; null when the short code was not shown.
Title.
Release year, when shown.
Tags on the review.
Whether this was a rewatch; null when the card does not say.
Link to the review.
The collection this film belongs to, or null.
Collection slug.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/letterboxd/films/parasite-2019" \
-H "x-api-key: YOUR_API_KEY"Responses
Film.