Get a Letterboxd filmography
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.
/v1/letterboxd/personx-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
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
directorPerson slug, as in letterboxd.com/<role>/<slug>/. Provide slug (with an optional role) or url.
max 200 chars
bong-joon-hoA letterboxd.com person URL such as https://letterboxd.com/director/<slug>/ (a person page or any of its sub-pages).
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
Person details.
Person slug.
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
Public letterboxd.com filmography page.
absolute HTTPS URL
boxd.it short link, or null.
absolute HTTPS URL
Name.
Biography, or null.
Portrait image URL, or null.
absolute HTTPS URL
TMDB person ID, or null.
≥ 0
Every role this person has a filmography for.
up to 50 items
Always included.
Always included.
Always included.
≥ 0
Films in the selected role, in Letterboxd's default popularity order.
up to 500 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. |