Letterboxd
Film ratings, popular films and film reviews
Letterboxd provides films with ratings, cast, location-dependent watch services and popular reviews, plus popularity-ranked lists by time period, genre and decade; some details may be unavailable.
Your information
Film name or Letterboxd film link, for example Past Lives or https://letterboxd.com/film/past-lives/.
More options
Release year to distinguish films with the same title, for example 2023.
Maximum popular reviews to return, for example 10.
Example results
Past Lives (2023)

After decades apart, childhood friends Nora and Hae Sung are reunited in New York for one fateful weekend as they confront notions of destiny, love, and the choices that make a life.
- Runtime
- 106 mins
- Directed by
- Celine Song
Genres
Themes
Cast
Where to watch
Rating distribution
| Stars | Ratings |
|---|---|
| 0.5 | 3.5K |
| 1 | 8.2K |
| 1.5 | 6.3K |
| 2 | 30.9K |
| 2.5 | 38K |
| 3 | 152.1K |
| 3.5 | 213.3K |
| 4 | 558K |
| 4.5 | 344.3K |
| 5 | 522.4K |
Popular reviews
Jay
86.3K likes
found a version without subtitles, to get the full arthur experience
Bobby Wagner
57.8K likes
telling your long lost friend and potential lover to watch eternal sunshine is an act of emotional violence
Patrick Willems
54.8K likes
Shoutout to the husband for being shockingly chill about this whole situation
cinema excelsior
36K likes
Adding the — You dream in a language that I can't understand to my own depressing cinematic universe that already includes hits like: — I love you. It'll pass. — Feelings can creep up just like that. — I'll go. And I'll stay. — I think it's nice that we share the same sky.
Framesofnick
32.9K likes
The white guy wrote a book called boner 💀💀
sawah 🦖
31.6K likes
“you make my life so big” is such a stupidly beautiful thing to say to someone I’m throwing up vehemently
jonathan fujii
28.9K likes
Why do “what ifs” in movies hurt so good
júlia
27.8K likes
”you're dreaming in a language that i can’t understand” what if i jump off a cliff?
kjarko
18.5K likes
“In another life” type narratives are literally psychological warfare
Lucy Ellman
17.3K likes
he was waiting on the steps 🥺😭
About the Letterboxd tool
Letterboxd (LB) Get film returns film details, ratings, watch services, and popular reviews from a title or film link.
List popular films returns popularity-ranked films for a period, optionally filtered by genre and decade.
Built from letterboxd.com. Last checked Sep 29, 2026.
Actions
Get film
1 creditGet a Letterboxd film by title or film link, with its ratings, cast, watch services and popular reviews. Fans may be shown as an abbreviated count; watch services depend on location.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Yearyear | Number | Optional | Release year to distinguish films with the same title, for example 2023.Example: 1982 |
Titletitle | Text | Required | Film name or Letterboxd film link, for example Past Lives or https://letterboxd.com/film/past-lives/.Example: Past Lives |
Max Reviewsmax_reviews | Number | Optional | Maximum popular reviews to return, for example 10.Example: 20 |
What you get
| Field | Type | Description |
|---|---|---|
Castcast | List | |
Fansfans | Value | Example: 69K |
Yearyear | Value | Example: 2023 |
Likeslikes | Value | Example: 902078 |
Listslists | Value | Example: 478320 |
Titletitle | Value | Example: Past Lives |
Genresgenres | List | |
Themesthemes | List | |
Runtimeruntime | Value | Example: 106 mins |
Taglinetagline | Value | Example: Why are they here? |
Watchedwatched | Value | Example: 2218498 |
Synopsissynopsis | Value | Example: After decades apart, childhood friends Nora and Hae Sung are reunited in New… |
Directorsdirectors | List | |
Poster Linkposter_link | Value | Example: https://a.ltrbxd.com/resized/film-poster/5/9/1/0/5/3/591053-past-lives-0-600-0… |
Average Ratingaverage_rating | Value | Example: 4.16 |
Where to Watchwhere_to_watch | List | |
Letterboxd Linkletterboxd_link | Value | Example: https://letterboxd.com/film/past-lives/ |
Popular Reviewspopular_reviews | List | |
Textpopular_reviews[].text | Value | Example: found a version without subtitles, to get the full arthur experience |
Likespopular_reviews[].likes | Value | Example: 86334 |
Ratingpopular_reviews[].rating | Value | Example: 4 |
Reviewerpopular_reviews[].reviewer | Text | Example: Jay |
Number of Ratingsnumber_of_ratings | Value | Example: 1876882 |
Rating Distributionrating_distribution | List | |
Countrating_distribution[].count | Value | Example: 3534 |
Starsrating_distribution[].stars | Number | Example: 0.5 |
Example result
For Title: Past Lives
{
"cast": [
"Greta Lee",
"Teo Yoo",
"John Magaro"
],
"fans": "69K",
"year": 2023,
"likes": null,
"lists": null,
"title": "Past Lives",
"genres": [
"Drama",
"Romance"
],
"themes": [
"Moving relationship stories",
"Heartfelt and sentimental family stories",
"Powerful stories of heartbreak and suffering"
],
"runtime": "106 mins",
"tagline": null,
"watched": null,
"synopsis": "After decades apart, childhood friends Nora and Hae Sung are reunited in New York for one fateful weekend as they confront notions of destiny, love, and the choices that make a life.",
"directors": [
"Celine Song"
],
"poster_link": "https://a.ltrbxd.com/resized/film-poster/5/9/1/0/5/3/591053-past-lives-0-600-0-900-crop.jpg?v=c600b7854e",
"average_rating": 4.16,
"where_to_watch": [
"Apple TV Store",
"Google Play Movies",
"Amazon Video"
],
"letterboxd_link": "https://letterboxd.com/film/past-lives/",
"popular_reviews": [
{
"text": "found a version without subtitles, to get the full arthur experience",
"likes": 86334,
"rating": 4,
"reviewer": "Jay"
},
{
"text": "telling your long lost friend and potential lover to watch eternal sunshine is an act of emotional violence",
"likes": 57773,
"rating": 4,
"reviewer": "Bobby Wagner"
},
{
"text": "Shoutout to the husband for being shockingly chill about this whole situation",
"likes": 54798,
"rating": 4,
"reviewer": "Patrick Willems"
}
],
"number_of_ratings": 1876882,
"rating_distribution": [
{
"count": 3534,
"stars": 0.5
},
{
"count": 8168,
"stars": 1
},
{
"count": 6272,
"stars": 1.5
}
]
}List popular films
1 creditList Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Genregenre | Text | Optional | Film genre, for example horror; use all for any genre.Example: Horror |
Decadedecade | Text | Optional | Release decade, for example 1990s; use all for any decade.Example: 1990s |
Periodperiod | Text | Optional | Popularity period, for example this_month.Example: This week |
Max Resultsmax_results | Number | Optional | Maximum number of films to return, for example 36.Example: 36 |
What you get
| Field | Type | Description |
|---|---|---|
Filmsfilms | List | |
Rankfilms[].rank | Number | Rank in popularity for the selected filters.Example: 1 |
Yearfilms[].year | Number | Example: 1999 |
Titlefilms[].title | Text | Example: The Sixth Sense |
Poster Linkfilms[].poster_link | Text | Example: https://a.ltrbxd.com/resized/film-poster/5/1/4/0/7/51407-the-sixth-sense-0-70-0… |
Average Ratingfilms[].average_rating | Number | Average rating out of 5.Example: 4.11 |
Letterboxd Linkfilms[].letterboxd_link | Text | Example: https://letterboxd.com/film/the-sixth-sense/ |
Example result
For Genre: Horror, Decade: 1990s, Period: This week, Max Results: 36
{
"films": [
{
"rank": 1,
"year": 1999,
"title": "The Sixth Sense",
"poster_link": "https://a.ltrbxd.com/resized/film-poster/5/1/4/0/7/51407-the-sixth-sense-0-70-0-105-crop.jpg?v=ab482dfeb6",
"average_rating": 4.11,
"letterboxd_link": "https://letterboxd.com/film/the-sixth-sense/"
},
{
"rank": 2,
"year": 1991,
"title": "The Silence of the Lambs",
"poster_link": "https://a.ltrbxd.com/resized/film-poster/5/1/7/8/2/51782-the-silence-of-the-lambs-0-70-0-105-crop.jpg?v=18d88bdff4",
"average_rating": 4.34,
"letterboxd_link": "https://letterboxd.com/film/the-silence-of-the-lambs/"
},
{
"rank": 3,
"year": 1997,
"title": "Perfect Blue",
"poster_link": "https://a.ltrbxd.com/resized/film-poster/4/6/1/7/5/46175-perfect-blue-0-70-0-105-crop.jpg?v=1ed5878cce",
"average_rating": 4.37,
"letterboxd_link": "https://letterboxd.com/film/perfect-blue/"
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@letterboxd",
"visibility": "public",
"operation": "get_film",
"version": 1,
"input": {
"title": "Past Lives"
},
"response": {
"format": "json"
}
}'What you can do with it
- Compare film ratings and review activity
- Find popular films by genre and decade
- Check where a film is available to watch
- Explore cast, themes, and directors for a film
Questions about Letterboxd
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Letterboxd tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Letterboxd account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from letterboxd.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
Where can I watch a particular film?
Get film returns watch services for a film found by title or film link; services depend on location.
Which films are popular this month?
List popular films returns films in popularity order for a selected period, including this month.
What are a film’s ratings and popular reviews?
Get film returns a film’s ratings and popular reviews when given its title or film link.