Skip to content
scrapeatlas.Dashboard

Get a Letterboxd filmography

Try in Playground

Get a director's, actor's or other crew member's Letterboxd page with biography, portrait, TMDB ID, every role they have credits for and the films in the selected role.

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

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

Query parameters
3
roleenumquery

Filmography role, for example director, actor, writer, producer, composer or cinematography (default actor).

one of: actor, director, co-director, additional-directing, producer, executive-producer, writer, original-writer, story, casting, editor, cinematography, additional-photography, camera-operator, assistant-director, composer, songs, sound, lighting, art-direction, production-design, set-decoration, costume-design, makeup, hairstyling, visual-effects, special-effects, stunts, choreography, title-design

Exampledirector
slugstringquery

Person slug, as in letterboxd.com/<role>/<slug>/. Provide slug (with an optional role) or url.

max 200 chars

Examplebong-joon-ho
urlstringquery

A letterboxd.com person URL such as https://letterboxd.com/director/<slug>/ (a person page or any of its sub-pages).

max 1024 chars

Response fields
33
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

Person details.

person.slugstring

Person slug.

person.roleenum

Role of the returned filmography.

one of: actor, director, co-director, additional-directing, producer, executive-producer, writer, original-writer, story, casting, editor, cinematography, additional-photography, camera-operator, assistant-director, composer, songs, sound, lighting, art-direction, production-design, set-decoration, costume-design, makeup, hairstyling, visual-effects, special-effects, stunts, choreography, title-design

person.urlstring

Public letterboxd.com filmography page.

absolute HTTPS URL

person.shortUrlstringnullable

boxd.it short link, or null.

absolute HTTPS URL

person.namestring

Name.

person.biostringnullable

Biography, or null.

person.imageUrlstringnullable

Portrait image URL, or null.

absolute HTTPS URL

person.tmdbIdintegernullable

TMDB person ID, or null.

≥ 0

Every role this person has a filmography for.

up to 50 items

person.roles.rolestring

Always included.

person.roles.labelstring

Always included.

person.roles.filmCountintegernullable

Always included.

≥ 0

Films in the selected role, in Letterboxd's default popularity order.

up to 500 items

films.idintegernullable

Always included.

≥ 0

films.lidstringnullable

Always included.

films.slugstring

Always included.

films.urlstring

Always included.

absolute HTTPS URL

films.namestring

Always included.

films.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.