List a Letterboxd member's diary
List a member's most recent diary entries with watched date, film, rating, like, rewatch and review flags.
/v1/letterboxd/user-diaryx-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 diary entries, newest first.
up to 50 items
Always included.
Always included.
absolute HTTPS URL
Always included.
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.
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. |