Letterboxd

List Letterboxd person or studio films

List the films in a Letterboxd person or studio filmography; a studio returns its first 24.

GET/v1/letterboxd/people/{role}/{slug}/films
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
rolestringrequiredpath

Crew role the person is filed under, e.g. `director`, `actor`, `producer`, `editor`, `cinematography` or `studio`.

one of: director, actor, writer, composer, studio, producer, executive-producer, editor, cinematography, original-writer, story, production-design, art-direction, set-decoration, costume-design, makeup, hairstyling, sound, visual-effects, stunts, casting, lighting, camera-operator, assistant-director, additional-directing, additional-photography, special-effects, songs

slugstringrequiredpath

Letterboxd person or studio slug: letters, digits and hyphens, or `contributor:` with digits, e.g. `bong-joon-ho`. Input is lowercased. Required, no default; 1 to 200 characters.

min 1 chars · max 200 chars

Response fields
22

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the person or studio does not exist.

one of: found, not_found

The filmography when found; otherwise null.

datapersonrole
string

Crew role the person is filed under, e.g. `director`, `actor`, `producer`, `editor`, `cinematography` or `studio`.

one of: director, actor, writer, composer, studio, producer, executive-producer, editor, cinematography, original-writer, story, production-design, art-direction, set-decoration, costume-design, makeup, hairstyling, sound, visual-effects, stunts, casting, lighting, camera-operator, assistant-director, additional-directing, additional-photography, special-effects, songs

datapersonslug
string

Person or studio slug.

datapersonname
stringnullable

The person or studio name.

datapersonheading
stringnullable

The heading, e.g. `Films directed by Bong Joon Ho`.

datapersontmdbId
integernullable

TMDB person id, when present.

datapersonimage
stringnullable

Portrait URL. Link only; the image is not hosted by Social Fetch.

datapersonbio
stringnullable

Biography as readable text with paragraph breaks, when available.

datapersonbioTruncated
boolean

Whether the biography is only the opening part.

The films in the filmography. A director, actor or other crew role lists every film; a studio lists its first 24. One call returns these only.

datapersonfilms[]slug
string

Film slug, e.g. `parasite-2019`.

datapersonfilms[]id
integernullable

Numeric film id.

datapersonfilms[]shortCode
stringnullable

Short code used by `https://boxd.it/{shortCode}`.

datapersonfilms[]shortUrl
stringnullable

Derived short link; null when the short code was not shown.

datapersonfilms[]title
stringnullable

Title.

datapersonfilms[]year
integernullable

Release year, when shown.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/letterboxd/people/director/bong-joon-ho/films" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Filmography.