String docs
Site integrations

Letterboxd

Letterboxd members: profile with bio, location, website and social links, favorite films and counts; every diary entry with watched date, rating, like and rewatch; recent reviews and lists with their text and publish time; the public watchlist; and member search by name or username.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: letterboxd
  • Version: 1.0.0
  • Reads from: letterboxd.com
ActionDescriptionListed price
profileRead Letterboxd members' public profiles by username or URL: display name, bio and the links in it, location, website and social links, avatar, membership badge, favorite films, and counts of films, lists, following and followers.Billed per request at your plan's rates
diaryRead a Letterboxd member's film diary, most recently watched first: each entry's film and year, watched date, star rating, like, rewatch, whether it has a review, and the entry's own link. 50 entries a page, back to the first. For review text and exact publish times of recent entries, use feed.Billed per request at your plan's rates
feedRead a Letterboxd member's RSS feed: their most recent diary entries, up to 50, with review text, rating, like, rewatch and the exact time each was logged, followed by their lists with description and films. One request. For the full diary history, use diary.Billed per request at your plan's rates
searchFind Letterboxd members by name or username, in Letterboxd's own order: username, display name, badge, avatar and profile link. 20 members a page; pass a username to profile, diary or feed.Billed per request at your plan's rates
watchlistRead a Letterboxd member's public watchlist, the films they want to see, most recently added first: each film's title and year, id, slug and page. 28 films a page, up to limit (default 100, at most 1000). A member who hides their watchlist fails as not found.Billed per request at your plan's rates

profile

Read Letterboxd members' public profiles by username or URL: display name, bio and the links in it, location, website and social links, avatar, membership badge, favorite films, and counts of films, lists, following and followers.

POST https://request.usestring.ai/v1/integrations/letterboxd/profile

Input

Unknown fields are rejected.

FieldTypeDescription
usersstring[]Required. Letterboxd usernames such as davidehrlich, or letterboxd.com member URLs. 1 to 50 entries.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
usernamestring—
urlstring—
shortUrlstring | nullThe member's boxd.it short link, which survives a username change.
idstring | nullLetterboxd's numeric member id.
displayNamestring | null—
membershipstring | nullThe badge beside the name, such as Pro, Patron or HQ for an official account; null for a free member.
biostring | nullThe bio as plain text, in full.
bioLinksstring[]Every link in the bio, in order.
locationstring | null—
websitestring | nullThe website the member set as their own.
linksobject[]The website and social links under the member's name.
links[].labelstringThe link's label: a domain, a handle, or the network's name such as Instagram.
links[].urlstring—
avatarUrlstring | nullNull for the default avatar.
filmsinteger | nullFilms the member has logged as watched.
filmsThisYearinteger | nullDiary entries this calendar year.
listsinteger | null—
followinginteger | null—
followersinteger | null—
favoritesobject[]The up to four favorite films on the profile.
favorites[].namestringTitle and year, such as Marie Antoinette (2006)
favorites[].urlstring—

Example

curl https://request.usestring.ai/v1/integrations/letterboxd/profile \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "users": ["davidehrlich"]
  }'

data starts with these rows:

[
  {
    "username": "davidehrlich",
    "url": "https://letterboxd.com/davidehrlich/",
    "shortUrl": "https://boxd.it/1lKn",
    "id": "32192",
    "displayName": "davidehrlich",
    "membership": "Patron",
    "bio": "chief film critic for IndieWire.\n\nwriting a book about A24 (Norton/Liveright… 2028?)\n\ni only log what i watch for work, otherwise my page would just be Ice Age: The Meltdown.\n\nfollow IndieWire's Letterboxd HQ",
    "bioLinks": ["https://letterboxd.com/indiewire/"],
    "location": "New York City",
    "website": "http://www.indiewire.com",
    "links": [
      {
        "label": "indiewire.com",
        "url": "http://www.indiewire.com"
      },
      {
        "label": "davidehrlich",
        "url": "https://twitter.com/davidehrlich"
      }
    ],
    "avatarUrl": "https://a.ltrbxd.com/resized/avatar/twitter/3/2/1/9/2/shard/http___pbs.twimg.com_profile_images_1015061849321164801_S527QFnk-0-1000-0-1000-crop.jpg?v=e236c36c50",
    "films": 3487,
    "filmsThisYear": 210,
    "lists": 72,
    "following": 38,
    "followers": 220597,
    "favorites": [
      {
        "name": "Marie Antoinette (2006)",
        "url": "https://letterboxd.com/film/marie-antoinette-2006/"
      },
      {
        "name": "Linda Linda Linda (2005)",
        "url": "https://letterboxd.com/film/linda-linda-linda/"
      },
      {
        "name": "The Bad and the Beautiful (1952)",
        "url": "https://letterboxd.com/film/the-bad-and-the-beautiful/"
      },
      {
        "name": "Thirst for Love (1966)",
        "url": "https://letterboxd.com/film/thirst-for-love/"
      }
    ]
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

diary

Read a Letterboxd member's film diary, most recently watched first: each entry's film and year, watched date, star rating, like, rewatch, whether it has a review, and the entry's own link. 50 entries a page, back to the first. For review text and exact publish times of recent entries, use feed.

POST https://request.usestring.ai/v1/integrations/letterboxd/diary

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. A Letterboxd username such as davidehrlich, or a letterboxd.com member URL. At least 1 character.
pagesintegerHow many pages of 50 entries to read, most recently watched first, from 1. From 1 to 50.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringLetterboxd's id for this viewing.
urlstringThe entry's own page, where its review is when it has one.
userstring—
filmstring—
filmYearinteger | null—
filmUrlstring | null—
watchedDatestring | nullThe date the member watched it, YYYY-MM-DD.
ratingnumber | nullStars out of 5 in half steps; null when unrated.
likedboolean—
rewatchboolean—
reviewedbooleanWhether the entry has a written review at url.

Example

curl https://request.usestring.ai/v1/integrations/letterboxd/diary \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "davidehrlich"
  }'

data starts with these rows:

[
  {
    "id": "1585363101",
    "url": "https://letterboxd.com/davidehrlich/film/heartland-2026/",
    "user": "davidehrlich",
    "film": "Heartland",
    "filmYear": 2026,
    "filmUrl": "https://letterboxd.com/film/heartland-2026/",
    "watchedDate": "2026-11-13",
    "rating": 2,
    "liked": false,
    "rewatch": false,
    "reviewed": false
  },
  {
    "id": "1583631468",
    "url": "https://letterboxd.com/davidehrlich/film/ebenezer-2026/",
    "user": "davidehrlich",
    "film": "Ebenezer",
    "filmYear": 2026,
    "filmUrl": "https://letterboxd.com/film/ebenezer-2026/",
    "watchedDate": "2026-11-12",
    "rating": 1.5,
    "liked": false,
    "rewatch": false,
    "reviewed": true
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

feed

Read a Letterboxd member's RSS feed: their most recent diary entries, up to 50, with review text, rating, like, rewatch and the exact time each was logged, followed by their lists with description and films. One request. For the full diary history, use diary.

POST https://request.usestring.ai/v1/integrations/letterboxd/feed

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. A Letterboxd username such as davidehrlich, or a letterboxd.com member URL. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstring—
kindstringwatch for a diary entry without a review, review, or list.
urlstring—
userstring—
titlestringThe feed's title: film, year and stars for an entry, the name for a list.
publishedAtstring | nullWhen the member logged or published it, RFC 3339 in UTC.
textstring | nullThe review, or a list's description and films, as plain text; null for a watch.
filmstring | null—
filmYearinteger | null—
watchedDatestring | nullThe date the member watched it, YYYY-MM-DD.
ratingnumber | nullStars out of 5 in half steps; null when unrated.
likedboolean | null—
rewatchboolean | null—
tmdbIdinteger | nullThe film's The Movie Database id.
posterUrlstring | null—

Example

curl https://request.usestring.ai/v1/integrations/letterboxd/feed \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "davidehrlich"
  }'

data starts with these rows:

[
  {
    "id": "1585363101",
    "kind": "watch",
    "url": "https://letterboxd.com/davidehrlich/film/heartland-2026/",
    "user": "davidehrlich",
    "title": "Heartland, 2026 - ★★",
    "publishedAt": "2026-11-13T23:33:59Z",
    "text": null,
    "film": "Heartland",
    "filmYear": 2026,
    "watchedDate": "2026-11-13",
    "rating": 2,
    "liked": false,
    "rewatch": false,
    "tmdbId": 1543469,
    "posterUrl": "https://a.ltrbxd.com/resized/film-poster/1/4/1/8/2/6/3/1418263-heartland-2026-0-600-0-900-crop.jpg?v=ca54060ea1"
  },
  {
    "id": "1583631468",
    "kind": "review",
    "url": "https://letterboxd.com/davidehrlich/film/ebenezer-2026/",
    "user": "davidehrlich",
    "title": "Ebenezer, 2026 - ★½",
    "publishedAt": "2026-11-12T17:05:33Z",
    "text": "A Sauvage and jowly overactor in dire need of career rehabilitation could hardly ask for a better part to play than Ebenezer Scrooge. He’s a cruel miser of a man who comes to learn the error of his ways over the course of a ghost story that preys upon Christian precepts of redemption and forgiveness (along with the more secular warm and fuzzies of seeing a bad guy discover the joys of being good). Indeed, what is “cancel culture” if not a shackled delusion that visits self-made pariahs in the dead of night, and what is Charles Dickens’ “A Christmas Carol” if not a plea to believe that even the most odious of souls are still capable of being saved?\n\nIt’s been reported that Johnny Depp accepted the title role of Ti West’s “Ebenezer” at a fraction of his usual rate, but I suspect that he probably would have done this movie for free. While the embattled star earned more than $250 million for his work on the “Pirates of the Caribbean” franchise, even that psychotic number pales in comparison to the pricelessness of starring in a major studio Christmas movie that allows him to look just left of the camera and say lines like “I’m not the man I was!” and “I was once good, and I know I can be again!” before his character saves a cherubic little boy from certain death and invites a freezing beggar inside for a warm cup of tea. If an old crank like Scrooge can make his way back toward grace, why not the convicted star of “Mortdecai,” and the alleged perpetrator of several even more serious crimes?\n\nJohnny Depp may prefer for that to be framed as a rhetorical question, but his insufferable turn as literature’s most cantankerous moneylender demands an honest answer. For me, that answer is rather straightforward: While Depp has never been the subtlest of actors, his post-Sparrow pivot away from artistic curiosity has distended his talents into such a grotesque caricature of their former charm that “Ebenezer” left me feeling like I may never be able to empathize with his screen presence again.\n\nScrooge is obviously a scenery-chewer’s dream, but the crescent arc he traces from grinch to Christmas miracle is only believable enough to sustain Dickens’ fable if you believe it on both ends. Depp’s performance — an advent calendar of empty affectations without a soul to anchor them, every shot full of face and bereft of feeling — makes that exceedingly difficult. His offscreen unsavoriness certainly doesn’t help, but there’s a more immediate problem when the lights go down, one that makes him a unique case among Hollywood’s tainted array of mega-star actors: He seems to have become very bad at acting. Whatever my feelings about Depp as a human being, the truth is that I didn’t buy him as a glowering monster any more than I bought him as a beaming man who’s grown “better than his word.”\n\nAn unengaging Ebenezer is a tough break for a movie called “Ebenezer,” and screenwriter Nathaniel Halpern’s fidelity to the source material doesn’t exactly leave West with a wealth of opportunities to compensate for such fatal miscasting. West’s take on the holiday classic is faithful to the core — no Muppets, no ghosts of girlfriends past, no uncanny mo-capped Jim Carrey. As you might expect from the director of indie genre standouts like “Pearl” and “The House of the Devil,” West’s big idea is to scare the Dickens out of us by turning up the volume on this story’s implicit scariness. Sometimes literally, as this PG-13 carol offers a small handful of gentle jump-scares.\n\n~this review continues on IndieWire~",
    "film": "Ebenezer",
    "filmYear": 2026,
    "watchedDate": "2026-11-12",
    "rating": 1.5,
    "liked": false,
    "rewatch": false,
    "tmdbId": 1567605,
    "posterUrl": "https://a.ltrbxd.com/resized/film-poster/1/4/4/0/0/5/2/1440052-ebenezer-2026-0-600-0-900-crop.jpg?v=f9a47d0baf"
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

Find Letterboxd members by name or username, in Letterboxd's own order: username, display name, badge, avatar and profile link. 20 members a page; pass a username to profile, diary or feed.

POST https://request.usestring.ai/v1/integrations/letterboxd/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. A name or username to look for. At least 1 character.
pagesintegerHow many pages of 20 members to read, from 1. From 1 to 10.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
usernamestring—
urlstring—
displayNamestring | null—
membershipstring | nullThe badge beside the name, such as Pro, Patron or HQ for an official account; null for a free member.
avatarUrlstring | nullNull for the default avatar.

Example

curl https://request.usestring.ai/v1/integrations/letterboxd/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "indiewire"
  }'

data starts with these rows:

[
  {
    "username": "indiewire",
    "url": "https://letterboxd.com/indiewire/",
    "displayName": "IndieWire",
    "membership": "HQ",
    "avatarUrl": "https://a.ltrbxd.com/resized/avatar/upload/2/7/2/5/1/6/8/shard/avtr-0-80-0-80-crop.jpg?v=da346dea9d"
  },
  {
    "username": "davidehrlich",
    "url": "https://letterboxd.com/davidehrlich/",
    "displayName": "davidehrlich",
    "membership": "Patron",
    "avatarUrl": "https://a.ltrbxd.com/resized/avatar/twitter/3/2/1/9/2/shard/http___pbs.twimg.com_profile_images_1015061849321164801_S527QFnk-0-80-0-80-crop.jpg?v=e236c36c50"
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

watchlist

Read a Letterboxd member's public watchlist, the films they want to see, most recently added first: each film's title and year, id, slug and page. 28 films a page, up to limit (default 100, at most 1000). A member who hides their watchlist fails as not found.

POST https://request.usestring.ai/v1/integrations/letterboxd/watchlist

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. A Letterboxd username such as kurstboy, or a letterboxd.com member URL. At least 1 character.
limitintegerHow many films to return, most recently added first; default 100. From 1 to 1000.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
userstring—
filmstringTitle and year, such as The Narrow Margin (1952)
filmIdstring | nullLetterboxd's numeric film id.
slugstring—
urlstringThe film's page.

Example

curl https://request.usestring.ai/v1/integrations/letterboxd/watchlist \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "kurstboy",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "user": "kurstboy",
    "film": "The Narrow Margin (1952)",
    "filmId": "30937",
    "slug": "the-narrow-margin",
    "url": "https://letterboxd.com/film/the-narrow-margin/"
  },
  {
    "user": "kurstboy",
    "film": "Compulsion (1959)",
    "filmId": "28333",
    "slug": "compulsion",
    "url": "https://letterboxd.com/film/compulsion/"
  },
  {
    "user": "kurstboy",
    "film": "Between the Lines (1977)",
    "filmId": "128708",
    "slug": "between-the-lines",
    "url": "https://letterboxd.com/film/between-the-lines/"
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.