Skip to content
scrapeatlas.Dashboard

List a Letterboxd member's network

Try in Playground

List the members a member follows, or their followers, with display names, avatars and their own follower and following counts.

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

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

Query parameters
2
usernamestringrequiredquery

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

max 31 chars

Exampledave
typeenumquery

following (members this member follows, the default) or followers.

one of: following, followers

Examplefollowers
Response fields
25
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.

typeenum

following (members this member follows, the default) or followers.

one of: following, followers

totalintegernullable

Members the member follows (following) or who follow the member (followers), from the tab total, or null.

≥ 0

Members on the first page.

up to 30 items

members.usernamestring

Always included.

members.displayNamestringnullable

Always included.

members.urlstring

Always included.

absolute HTTPS URL

members.avatarUrlstringnullable

Always included.

absolute HTTPS URL

members.followerCountintegernullable

Always included.

≥ 0

members.followingCountintegernullable

Always included.

≥ 0

totalPagesintegernullable

Always null here: Letterboxd shows no page numbers on network pages; use total and hasMore.

≥ 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.