List a Letterboxd member's reviews
List a member's most recent reviews with film, rating, like, rewatch, watched date, spoiler flag, text, likes and comments.
/v1/letterboxd/user-reviewsx-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
Letterboxd username, as in letterboxd.com/<username>/ (case-insensitive, an optional leading @ is ignored). Responses return it lowercase.
Most recent reviews by the member.
up to 20 items
Always included.
Always included.
absolute HTTPS URL
Always included.
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
absolute HTTPS URL
Always included.
Always included.
≥ 0
Always included.
Always included.
Always included.
absolute HTTPS URL
Always included.
Always included.
≥ 0
Always included.
0.5 – 5
Always included.
Always included.
Always included.
Always included.
Always included.
Always included.
Always included.
≥ 0
Always included.
≥ 0
Pages in the member's whole listing, or null when the page does not show it.
≥ 0
Whether the member's listing has more than the returned first page.
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. |