Letterboxd API endpoint
Returns a member's public profile stats (films watched, lists, following/followers). No private data — everything is visible to a logged-out visitor.
/letterboxd/member/{username}Path parameters:
username (required) — Letterboxd username.Response includes display_name, films_watched, films_this_year, lists, following, followers, uri.
| Field | In the sample | Value in the sample |
|---|---|---|
| username | Has a value | |
| display_name | Has a value | |
| films_watched | Has a value | 2,592 |
| films_this_year | Has a value | 113 |
| lists | Has a value | 158 |
| following | Has a value | 79 |
| followers | Has a value | 36,435 |
| uri | Has a value | letterboxd.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | Letterboxd username | dave | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/letterboxd/member/dave" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"username": "dave",
"display_name": "Dave Vis",
"films_watched": 2570,
"films_this_year": 85,
"lists": 156,
"following": 76,
"followers": 35352,
"uri": "https://letterboxd.com/dave/",
"source_url": "https://letterboxd.com/dave/"
}
}Request schema
No body schema
Response schema
#/definitions/letterboxd.memberResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | letterboxd.MemberResponse | No | ||||
| data.display_name | string | No | ||||
| data.films_this_year | integer | No | ||||
| data.films_watched | integer | No | ||||
| data.followers | integer | No | ||||
| data.following | integer | No | ||||
| data.lists | integer | No | ||||
| data.source_url | string | No | ||||
| data.uri | string | No | ||||
| data.username | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/letterboxd/member/dave" \
-H "x-api-key: $CRAWLORA_API_KEY"