Skip to content
scrapeatlas.Dashboard

List a Letterboxd member's activity

Try in Playground

List a member's latest diary entries, reviews with full text and lists, with ratings, likes, rewatches, watched dates and TMDB IDs.

GET/v1/letterboxd/user-feedx-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
35
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.

Latest diary entries, reviews and lists, newest first.

up to 100 items

items.kindenum

Always included.

one of: watch, review, list, other

items.idstring

Always included.

items.urlstring

Always included.

absolute HTTPS URL

items.titlestring

Always included.

items.publishedAtstringnullable

Always included.

Always included.

items.film.namestring

Always included.

items.film.yearintegernullable

Always included.

≥ 0

items.film.slugstringnullable

Always included.

items.film.tmdbIdintegernullable

Always included.

≥ 0

items.film.posterUrlstringnullable

Always included.

absolute HTTPS URL

items.watchedDatestringnullable

Always included.

items.rewatchbooleannullable

Always included.

items.ratingnumbernullable

Always included.

0.5 – 5

items.likedbooleannullable

Always included.

items.textstringnullable

Always included.

Always included.

up to 100 items

items.listFilms.namestring

Always included.

items.listFilms.slugstring

Always included.

items.listFilms.urlstring

Always included.

absolute HTTPS URL

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.