Letterboxd scraper API
The InsightSocial Letterboxd API has 16 endpoints, from 20 credits a call. A film call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.
The Letterboxd scraper API for films, member reviews, diaries, lists and watchlists, as JSON, on the same key as every other platform. No API access request.
16 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/letterboxd/film?slug=parasite-2019" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Letterboxd data can you get?
Public Letterboxd data only, in the same JSON envelope as every other platform. Every Letterboxd endpoint is beta: inside data it returns Letterboxd's own structure under our naming rules (snake_case keys, string ids, ISO times where Letterboxd gives a timestamp), not the shared profile and post schema, and fields may change.
Films and filmographies
One film with its synopsis, cast, crew, release dates, rating and similar films, and the films of a director, actor or studio.
Members
A member's public header, statistics, followers, following and the most popular members on the site.
Reviews and diaries
A member's reviews with rating and full text, one review in full, their diary with watch dates and rewatch flags, and recent activity.
Lists, watchlists and tags
A member's public lists, one list with its films, the films they have watched, their watchlist and their tags.
What people build with the Letterboxd API
Film research
Pull a film's cast, crew, release dates and rating, then the filmography of its director, to build datasets for recommendations or editorial work.
Review analysis
Read the reviews of critics or members you follow, with ratings and full text, and feed them to your own model for themes and sentiment.
Audience taste profiles
Combine a member's diary, watched films and lists to see what they watch, how they rate it and how often they rewatch.
Letterboxd API endpoints
All 16 Letterboxd endpoints and their price in credits. Every one has a fixed price.
| Endpoint | Credits | What it returns |
|---|---|---|
| /film | 20 | Get a Letterboxd film's identity, synopsis, cast, crew, releases, rating, similar films and popular reviews. |
| /members/popular | 20 | List the first 30 popular Letterboxd members, with their public counts. |
| /people/films | 20 | List the films in a Letterboxd person or studio filmography; a studio returns its first 24. |
| /user | 20 | Get a Letterboxd member's public header and the number of films they have watched. |
| /user/activity | 20 | List a Letterboxd member's recent activity: watches, reviews, lists and stories. |
| /user/diary | 20 | List the first 50 diary entries of a Letterboxd member, with dates, ratings, likes and rewatch flags. |
| /user/film/review | 20 | Get a Letterboxd review with its full text, rating, watched date, tags, likes and rewatch number. |
| /user/films | 20 | List the first 72 films a Letterboxd member has watched, with their rating and like. |
| /user/followers | 20 | List the first 25 followers of a Letterboxd member, with display name, avatar, badge and counts. |
| /user/following | 20 | List the first 25 accounts a Letterboxd member follows. |
| /user/list | 20 | Get a Letterboxd list with its description, tags, likes, clones and first 100 films. |
| /user/lists | 20 | List the first 12 public lists of a Letterboxd member, with film counts, likes and poster slugs. |
| /user/reviews | 20 | List the first 12 reviews of a Letterboxd member, with rating, likes, spoiler flag and text. |
| /user/stats | 20 | Get a Letterboxd member's statistics, or the partial header when they are restricted. |
| /user/tags | 20 | List up to 120 of a Letterboxd member's tags, with the number of films under each. |
| /user/watchlist | 20 | List the first 28 films on a Letterboxd member's public watchlist; a private one answers `restricted`. |
Parameters, response fields and examples for each endpoint are in the Letterboxd API reference.
InsightSocial vs the official Letterboxd API
Letterboxd's own API is not open for general use: access is granted by Letterboxd on request.
| InsightSocial API | Official Letterboxd API | |
|---|---|---|
| Access | Sign in and copy a key | Granted by Letterboxd on request |
| Whose data | Any public film or member page | What your approved app is allowed to read |
| Cost per call | 20 credits | Not sold openly; access by request |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Letterboxd API cost?
Letterboxd calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 film lookups at 20 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Letterboxd data in plain English. Same account, same credits.
Letterboxd API: frequently asked questions
Letterboxd has an API, but access is granted by Letterboxd on request rather than open to every developer. The InsightSocial API reads public Letterboxd pages with one key and no application.
Yes. /v1/letterboxd/user/reviews lists a member's first 12 reviews with rating, likes and text, /v1/letterboxd/user/film/review returns one review in full, and /v1/letterboxd/user/diary returns the first 50 diary entries with dates, ratings and rewatch flags.
Most member lists return the first page Letterboxd shows: 72 watched films, 28 watchlist films, 25 followers, 12 lists or 12 reviews. Each endpoint's reference page states its limit. A private watchlist answers as restricted.
They return Letterboxd's own record shapes under our naming rules (snake_case keys, string ids and ISO times) rather than the shared profile and post entities, so fields may change. Every Letterboxd endpoint is 20 credits a call. Calls that fail or find nothing are free.
No. There is no Letterboxd app, OAuth flow or review. One API key in the x-api-key header works for Letterboxd and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Letterboxd's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Letterboxd API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API