Get a Letterboxd profile
Get a member's display name, avatar, bio, location, website, four favorite films and, when public, their all-time stats.
/v1/letterboxd/profilex-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
Letterboxd username, as in letterboxd.com/<username>/ (case-insensitive, an optional leading @ is ignored). Responses return it lowercase.
max 31 chars
daveTrue 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
Member profile.
Letterboxd username.
Letterboxd short ID of the member.
Public letterboxd.com profile.
absolute HTTPS URL
boxd.it short link to the profile.
absolute HTTPS URL
Display name, or null.
Avatar image URL, or null.
absolute HTTPS URL
Bio text with paragraphs separated by blank lines, or null.
Location, or null.
Website, or null.
Up to four favorite films.
up to 4 items
Always included.
Always included.
Always included.
≥ 0
Always included.
absolute HTTPS URL
Always included.
absolute HTTPS URL
All-time stats, or null when the member's stats page is not public.
Films watched, or null.
≥ 0
Hours watched, or null.
≥ 0
Distinct directors watched, or null.
≥ 0
Distinct production countries watched, or null.
≥ 0
Longest weekly watching streak in weeks, or null.
≥ 0
Days with two or more films watched, or null.
≥ 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. |