Skip to content
scrapeatlas.Dashboard

List a Letterboxd member's watched films

Try in Playground

List the films a member has watched most recently, with their rating, like and review link.

GET/v1/letterboxd/user-filmsx-api-key
x-api-keystringrequiredheader

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

Query parameters
1
usernamestringrequiredquery

Letterboxd username, as in letterboxd.com/<username>/ (case-insensitive, an optional leading @ is ignored). Responses return it lowercase.

max 31 chars

Exampledave
Response fields
26
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

usernamestring

Letterboxd username, as in letterboxd.com/<username>/ (case-insensitive, an optional leading @ is ignored). Responses return it lowercase.

Most recently watched films.

up to 100 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

films.ratingnumbernullable

Always included.

0.5 – 5

films.likedbooleannullable

Always included.

films.reviewUrlstringnullable

Always included.

absolute HTTPS URL

totalPagesintegernullable

Pages in the member's whole listing, or null when the page does not show it.

≥ 0

hasMoreboolean

Whether the member's listing has more than the returned first page.

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.