Letterboxd API endpoint
Returns a person's Letterboxd filmography by `slug`, ranked by popularity for one credit role. `role` is `actor` (default) or `director`, and `limit` defaults to 10 with a max of 50. The response has the person's name, role, and films with `slug`, title and Letterboxd URL.
/letterboxd/person/{slug}Path parameters:
slug (required) — Letterboxd person slug.Query parameters:
role (optional, default actor). Allowed values: actor, director.limit (optional, default 10, max 50).Response includes name, role, and films[] (slug, title, uri), ranked by Letterboxd popularity for that credit role.
| Field | Filled in, of 19 checked | Values in the sample |
|---|---|---|
| slug | 19 | |
| title | 19 | |
| uri | 19 | letterboxd.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Letterboxd person slug | bong-joon-ho | |
| role | string | No | Credit role, default actor Allowed values: actor, director. | ||
| limit | integer | No | Max films, default 10, max 50 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/letterboxd/person/bong-joon-ho?role=actor&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "bong-joon-ho",
"role": "director",
"name": "Bong Joon Ho",
"films": [
{
"slug": "parasite-2019",
"title": "Parasite",
"uri": "https://letterboxd.com/film/parasite-2019/"
},
{
"slug": "mickey-17",
"title": "Mickey 17",
"uri": "https://letterboxd.com/film/mickey-17/"
},
{
"slug": "memories-of-murder",
"title": "Memories of Murder",
"uri": "https://letterboxd.com/film/memories-of-murder/"
}
],
"source_url": "https://letterboxd.com/director/bong-joon-ho/"
}
}Request schema
No body schema
Response schema
#/definitions/letterboxd.personResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | letterboxd.PersonResponse | No | ||||
| data.films | array | No | ||||
| data.films[].slug | string | No | Letterboxd film slug. Use it with the film endpoint for full detail. | |||
| data.films[].title | string | No | Title of the film. | |||
| data.films[].uri | string | No | Link to the film's page on Letterboxd. | |||
| data.name | string | No | ||||
| data.role | string | No | ||||
| data.slug | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/person/bong-joon-ho?role=actor&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"