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
| Action | Description | Listed price |
|---|---|---|
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. | Billed per request at your plan's rates |
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. | Billed per request at your plan's rates |
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. | Billed per request at your plan's rates |
search | 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. | Billed per request at your plan's rates |
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. | 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/profileInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
users | string[] | 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:
| Field | Type | Description |
|---|---|---|
username | string | — |
url | string | — |
shortUrl | string | null | The member's boxd.it short link, which survives a username change. |
id | string | null | Letterboxd's numeric member id. |
displayName | string | null | — |
membership | string | null | The badge beside the name, such as Pro, Patron or HQ for an official account; null for a free member. |
bio | string | null | The bio as plain text, in full. |
bioLinks | string[] | Every link in the bio, in order. |
location | string | null | — |
website | string | null | The website the member set as their own. |
links | object[] | The website and social links under the member's name. |
links[].label | string | The link's label: a domain, a handle, or the network's name such as Instagram. |
links[].url | string | — |
avatarUrl | string | null | Null for the default avatar. |
films | integer | null | Films the member has logged as watched. |
filmsThisYear | integer | null | Diary entries this calendar year. |
lists | integer | null | — |
following | integer | null | — |
followers | integer | null | — |
favorites | object[] | The up to four favorite films on the profile. |
favorites[].name | string | Title and year, such as Marie Antoinette (2006) |
favorites[].url | string | — |
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/diaryInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
user | string | Required. A Letterboxd username such as davidehrlich, or a letterboxd.com member URL. At least 1 character. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
id | string | Letterboxd's id for this viewing. |
url | string | The entry's own page, where its review is when it has one. |
user | string | — |
film | string | — |
filmYear | integer | null | — |
filmUrl | string | null | — |
watchedDate | string | null | The date the member watched it, YYYY-MM-DD. |
rating | number | null | Stars out of 5 in half steps; null when unrated. |
liked | boolean | — |
rewatch | boolean | — |
reviewed | boolean | Whether 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/feedInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
user | string | Required. 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:
| Field | Type | Description |
|---|---|---|
id | string | — |
kind | string | watch for a diary entry without a review, review, or list. |
url | string | — |
user | string | — |
title | string | The feed's title: film, year and stars for an entry, the name for a list. |
publishedAt | string | null | When the member logged or published it, RFC 3339 in UTC. |
text | string | null | The review, or a list's description and films, as plain text; null for a watch. |
film | string | null | — |
filmYear | integer | null | — |
watchedDate | string | null | The date the member watched it, YYYY-MM-DD. |
rating | number | null | Stars out of 5 in half steps; null when unrated. |
liked | boolean | null | — |
rewatch | boolean | null | — |
tmdbId | integer | null | The film's The Movie Database id. |
posterUrl | string | 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.
search
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/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. A name or username to look for. At least 1 character. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
username | string | — |
url | string | — |
displayName | string | null | — |
membership | string | null | The badge beside the name, such as Pro, Patron or HQ for an official account; null for a free member. |
avatarUrl | string | null | Null 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/watchlistInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
user | string | Required. A Letterboxd username such as kurstboy, or a letterboxd.com member URL. At least 1 character. |
limit | integer | How 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:
| Field | Type | Description |
|---|---|---|
user | string | — |
film | string | Title and year, such as The Narrow Margin (1952) |
filmId | string | null | Letterboxd's numeric film id. |
slug | string | — |
url | string | The 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.
Linktree
Linktree link-in-bio profiles: display name, bio, avatar, verification, and every link and social icon on the page, each with its target's platform and handle.
GitHub
GitHub users' public profiles with their linked social accounts and profile README, the repositories a user starred and when, a user's recent public activity and the issues and pull requests they commented on, and a search for accounts by the name on the profile.