Letterboxd API scraper API
The Letterboxd API returns film details, ratings and user data as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary film endpoint returns a film's title, year, directors, cast, genres, runtime, poster, IMDb/TMDb ids, average rating and rating count, and you can pull a user, their films, diary and lists, film reviews, browse, similar films and popular lists. It is built for film apps, recommendation engines and media research that need Letterboxd data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, film, on .
{
"method": "POST",
"url": "https://api.reefapi.com/letterboxd/v1/film",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"film": "parasite-2019"
}
}{
"ok": true,
"meta": {
"api": "letterboxd",
"endpoint": "film",
"mode": "live",
"latency_ms": 1792.1,
"record_count": 1,
"bytes": 322776,
"cache_hit": false,
"method": "public_html_json_ld"
},
"data": {
"film": {
"slug": "parasite-2019",
"title": "Parasite",
"name": "Parasite",
"year": null,
"tagline": "Act like you own the place.",
"description": "All unemployed, Ki-taek's family takes peculiar interest in the wealthy and glamorous Parks for their livelihood until they get entangled in an unexpected incident.",
"poster_url": "https://a.ltrbxd.com/resized/film-poster/4/2/6/4/0/6/426406-parasite-[redacted-phone]-crop.jpg?v=8f5653f710",
"runtime_minutes": 133,
"directors": [
"Bong Joon Ho"
],
"director": "Bong Joon Ho",
"cast": [
{
"name": "[redacted-name]",
"role": "Kim Ki-taek"
},
{
"name": "[redacted-name]",
"role": "Park Dong-ik"
},
{
"name": "[redacted-name]",
"role": "Yeon-kyo"
}
],
"crew": {
"producer": [
"Jang Young-hwan",
"Kwak Sin-ae",
"Moon Yang-kwon"
],
"writer": [
"Kim Dae-hwan",
"Bong Joon Ho",
"Han Jin-won"
],
"story": [
"Bong Joon Ho"
],
"editor": [
"Yang Jin-mo"
],
"cinematography": [
"Hong Kyung-pyo"
],
"assistant_director": [
"Kim Seong-sik",
"Yoon Young-woo"
],
"executive_producer": [
"Miky Lee",
"Heo Min-heoi",
"Lim Myeong-gyun"
],
"production_design": [
"Lee Ha-jun"
],
"art_direction": [
"Mo So-ra"
],
"set_decoration": [
"Noh Seung-goog",
"Song Suk-ki",
"Cho Won-woo"
],
"visual_effects": [
"Hong Jeong-ho",
"Peter Ahn",
"Ha Jae-gu"
],
"stunts": [
"Yoo Mi-jin",
"Kwon Ji-hoon",
"Kang Gyeong-su"
],
"composer": [
"Jung Jae-il"
],
"sound": [
"Choi Tae-young",
"Eun Hee-soo",
"Kim Byung-in"
],
"costume_design": [
"Choi Se-yeon"
],
"makeup": [
"Kim Ho-sik",
"Kwak Tae-yong",
"Hwang Hyo-kyun"
]
},
"writers": [
"Kim Dae-hwan",
"Bong Joon Ho",
"Han Jin-won"
],
"cinematography": [
"Hong Kyung-pyo"
],
"editors": [
"Yang Jin-mo"
],
"composers": [
"Jung Jae-il"
],
"producers": [
"Jang Young-hwan",
"Kwak Sin-ae",
"Moon Yang-kwon"
],
"genres": [
"Thriller",
"Comedy",
"Drama"
],
"tags": [
"Thriller",
"Comedy",
"Drama"
],
"themes": [
"Intense violence and sexual transgression",
"Humanity and the world around us",
"Moving relationship stories"
],
"alternative_titles": [
"ชนชั้นปรสิต",
"パラサイト 半地下の家族：2019",
"Parazit"
],
"similar_films": [
{
"slug": "no-other-choice-2025",
"name": null,
"url": "https://letterboxd.com/film/no-other-choice-2025/",
"user_rating": null
},
{
"slug": "the-housemaid",
"name": null,
"url": "https://letterboxd.com/film/the-housemaid/",
"user_rating": null
},
{
"slug": "saltburn",
"name": null,
"url": "https://letterboxd.com/film/saltburn/",
"user_rating": null
}
],
"countries": [
"South Korea"
],
"languages": [
"English",
"German",
"Korean"
],
"production_companies": [
"Barunson E&A"
],
"imdb_id": "tt6751668",
"tmdb_id": "496243",
"imdb_url": "https://www.imdb.com/title/tt6751668/",
"tmdb_url": "https://www.themoviedb.org/movie/496243/",
"url": "https://letterboxd.com/film/parasite-2019/",
"avg_rating": 4.52,
"rating_count": 5578743,
"review_count": 744252,
"watch_count": 7231524,
"like_count": 3759340,
"list_count": 865763,
"watches": 7231524,
"lists": 865763,
"likes": 3759340,
"fans": null
}
}
}What the Letterboxd API scraper API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| film | Full Letterboxd film detail by film slug or URL: title, year, directors, cast, genres, runtime, poster, IMDb/TMDb IDs, average rating, total ratings, watch count, like count, and list appearances. | Content platforms call film to get full Letterboxd film detail by film slug or URL. | film, film_slug, url |
| user | Public Letterboxd member profile and stats by username: display name, avatar, bio, film/list/follower counts, and the member's favourite films. | Research tools call user to get public Letterboxd member profile and stats by username. | user |
| user_films | Paginated list of films a Letterboxd member has watched and rated, with their personal star rating for each. | Community analysts call user_films to get paginated list of films a Letterboxd member has watched and rated, with their personal star r…. | user, page, per_page |
| user_diary | Paginated diary entries for a Letterboxd member: film slug, name, watch date, and star rating for each viewing. | Media monitors call user_diary to get paginated diary entries for a Letterboxd member. | user, page, per_page |
| list | A public Letterboxd curated film list: title, description, and the paginated film entries with user ratings. | Content platforms call list to get a public Letterboxd curated film list. | user, list, page, per_page |
| film_reviews | Paginated public reviews for a Letterboxd film: reviewer username, display name, star rating, review text, and like count. | Research tools call film_reviews to get paginated public reviews for a Letterboxd film. | film, film_slug, url, page, per_page |
| browse | Browse Letterboxd films with optional genre / decade / year filters, ordered by popularity, rating, release date, or runtime (paginated): slug, name, URL, and average rating. | Community analysts call browse to get browse Letterboxd films with optional genre / decade / year filters, ordered by popularity, r…. | sort, genre, decade, year, page, ... |
| film_similar | Films Letterboxd shows as similar/related to a given film: slug, name, URL — useful for recommendation and discovery off a single seed film. | Media monitors call film_similar to get films Letterboxd shows as similar/related to a given film. | film, film_slug, url |
| lists_popular | Browse Letterboxd's most popular member-curated film lists for a time window (week/month/year/all): list title, owner username, list slug+URL, and a preview of the first films. | Content platforms call lists_popular to get browse Letterboxd's most popular member-curated film lists for a time window (week/month/year…. | period, page, per_page |
| user_lists | The public film lists a Letterboxd member has created (paginated): list title, slug+URL, and a preview of the first films in each list. | Research tools call user_lists to get the public film lists a Letterboxd member has created (paginated). | user, page, per_page |
| search | Search Letterboxd for films, members, or curated lists by keyword — returns matching results with ratings and links. | Community analysts call search to search Letterboxd for films, members, or curated lists by keyword. | query, type, page, per_page |
Call film from your stack
curl -X POST https://api.reefapi.com/letterboxd/v1/film \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"film":"parasite-2019"}'import requests
r = requests.post(
"https://api.reefapi.com/letterboxd/v1/film",
headers={"x-api-key": REEF_KEY},
json={
"film": "parasite-2019"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/letterboxd/v1/film", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"film": "parasite-2019"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.letterboxd.film with {"film":"parasite-2019"}.Who uses this API and why
- Film apps call film to enrich a title with rating, cast and cross-links to IMDb and TMDb.
- Recommendation engines use film_similar and lists_popular to surface related films.
- Media research uses user_films and film_reviews to study taste and sentiment.
Questions developers ask before integrating
What is the Letterboxd API scraper API?
Letterboxd API scraper API is a ReefAPI endpoint group for letterboxd api scraper It returns live JSON through POST requests under /letterboxd/v1.
Is the Letterboxd API scraper API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Letterboxd API scraper calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Letterboxd API scraper login or account?
No login to Letterboxd API scraper is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Letterboxd API scraper data?
The page example is captured from a live film call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Letterboxd API scraper API use?
Letterboxd API scraper actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Letterboxd API scraper from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call letterboxd actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Letterboxd API scraper API a Letterboxd API scraper scraper?
It is the managed alternative to a DIY Letterboxd API scraper scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same letterboxd api scraper back as clean JSON.
Why does my Letterboxd API scraper scraper keep getting blocked?
Most Letterboxd API scraper scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.