Letterboxd
Social film discovery and tracking platform
| API | Protocol | Base URL | Docs | Reference | OpenAPI | SDKs |
|---|---|---|---|---|---|---|
| Main | rest | https://api.letterboxd.com/api/v0 | link | — | — | — |
Actions (90)
Films · 16
- Autocomplete filmsGET /films/autocomplete
Autocomplete film titles for search suggestions.
documented - Get film availabilityGET /film/{id}/availability
Get availability data for a film by ID.
documented - Get film availability typesGET /films/availability-types
List available film service availability types.
documented - Get film by IDGET /film/{id}
Retrieve a film by its ID or TMDB ID (optionally with a member for custom posters).
documented - Get film countriesGET /films/countries
List countries related to film data.
documented - Get film friendsGET /film/{id}/friends
Retrieve the authenticated member’s relationship data with a film for friends-related context.
documented - Get film genresGET /films/genres
List film genres.
documented - Get film languagesGET /films/languages
List available film languages.
documented - Get film members relationshipsGET /film/{id}/members
List members’ relationships with a film.
documented - Get film servicesGET /films/film-services
List film services/providers.
documented - Get film statisticsGET /film/{id}/statistics
Get statistical data about a film by ID.
documented - Get member’s relationship with filmGET /film/{id}/member/{member}
Get a specific member’s relationship with a film by ID.
documented - Get my relationship to filmGET /film/{id}/me
Get the authenticated member’s relationship with a film by ID.
documented - List filmsGET /films
Cursor-paginated list of films (with optional member context).
documented - Report filmPOST /film/{id}/report
Report a film by its ID.
documented - Update my relationship to filmPATCH /film/{id}/me
Update the authenticated user’s relationship with a film.
documented
Lists · 15
- Add comment to listPOST /list/{id}/comments
Post a comment to a list.
documented - Create listPOST /lists
Create a new list.
documented - Delete listDELETE /list/{id}
Delete a list by ID.
documented - Forget listPOST /list/{id}/forget
Remove a list from memory? (forget action on a list).
documented - Get listGET /list/{id}
Retrieve a list by ID.
documented - Get list commentsGET /list/{id}/comments
List comments for a given list.
documented - Get list entriesGET /list/{id}/entries
List the entries (films) in a list.
documented - Get list statisticsGET /list/{id}/statistics
Get statistics for a specific list.
documented - Get my relation to listGET /list/{id}/me
Get the authenticated member’s relation to a list.
documented - List listsGET /lists
List user-created lists.
documented - List lists topicsGET /lists/topics
List topics for lists.
documented - Report listPOST /list/{id}/report
Report a list by ID.
documented - Update listPATCH /list/{id}
Update a list’s details.
documented - Update listsPATCH /lists
Bulk update lists for the user.
documented - Update my relation to listPATCH /list/{id}/me
Update the authenticated member’s relation to a list.
documented
Members · 15
- Get memberGET /member/{id}
Retrieve a member by ID.
documented - Get member activityGET /member/{id}/activity
List a member’s activity.
documented - Get member list tagsGET /member/{id}/list-tags
List a member’s list tags.
documented - Get member list tags 2GET /member/{id}/list-tags-2
List additional member list tags.
documented - Get member log-entry tagsGET /member/{id}/log-entry-tags
List a member’s log-entry tags.
documented - Get member profileGET /member/{id}/me
Retrieve a member’s profile by ID.
documented - Get member review tagsGET /member/{id}/review-tags
List a member’s review tags.
documented - Get member review tags 2GET /member/{id}/review-tags-2
List additional member review tags.
documented - Get member statisticsGET /member/{id}/statistics
Get a member’s statistics.
documented - Get member watchlistGET /member/{id}/watchlist
Get a member’s watchlist.
documented - List membersGET /members
List Letterboxd members.
documented - List pronounsGET /members/pronouns
List available pronouns for members.
documented - Register memberPOST /members/register
Register a new member.
documented - Report memberPOST /member/{id}/report
Report a member by ID.
documented - Update member profilePATCH /member/{id}/me
Update a member’s profile.
documented
Log entries · 12
- Add log entry commentPOST /log-entry/{id}/comments
Post a comment to a log entry.
documented - Create log entriesPOST /log-entries
Create new log entries (diaries).
documented - Delete log entryDELETE /log-entry/{id}
Delete a log entry.
documented - Get log entryGET /log-entry/{id}
Retrieve a diary entry by ID.
documented - Get log entry commentsGET /log-entry/{id}/comments
List comments on a diary entry.
documented - Get log entry member relationsGET /log-entry/{id}/members
List member relationships for a log entry.
documented - Get log entry statisticsGET /log-entry/{id}/statistics
Get statistics for a log entry.
documented - Get my relation to log entryGET /log-entry/{id}/me
Get the authenticated member’s relation to a log entry.
documented - List log entriesGET /log-entries
List log entries (diaries) for the authenticated user.
documented - Report log entryPOST /log-entry/{id}/report
Report a log entry by ID.
documented - Update log entryPATCH /log-entry/{id}
Update a log entry.
documented - Update my relation to log entryPATCH /log-entry/{id}/me
Update the authenticated member’s relation to a log entry.
documented
Me · 10
- Check my tagGET /me/check-tag
Check the current user’s tag state.
documented - Collect itemPOST /me/collect-item
Add an item to the current user’s collection.
documented - Delete my tagDELETE /me/delete-tag
Delete the authenticated member’s tag.
documented - Deregister push notificationsPOST /me/deregister-push-notifications
Disable push notifications for the current user.
documented - Disable accountPOST /me/disable
Disable the current member’s account.
documented - Get my profileGET /me
Retrieve the authenticated member’s own profile.
documented - Register push notificationsPOST /me/register-push-notifications
Enable push notifications for the current user.
documented - Request validationPOST /me/validation-request
Request additional validation for the current user.
documented - Update my profilePATCH /me
Update the authenticated member’s profile.
documented - Update my tagPATCH /me/update-tag
Update the authenticated member’s tag.
documented
Stories · 8
- Add story commentPOST /story/{id}/comments
Post a comment to a story.
documented - Get storyGET /story/{id}
Retrieve a story by ID.
documented - Get story commentsGET /story/{id}/comments
List comments on a story.
documented - Get story my relationGET /story/{id}/me
Get the authenticated member’s relation to a story.
documented - Get story statisticsGET /story/{id}/statistics
Get statistics for a story.
documented - List storiesGET /stories
Get a list of stories.
documented - Update storyPATCH /story/{id}
Update a story’s content.
documented - Update story my relationPATCH /story/{id}/me
Update the authenticated member’s relation to a story.
documented
Auth · 4
- Check username availabilityGET /auth/username-check
Check whether a proposed username is valid and available for registration.
documented - Forgotten password requestPOST /auth/forgotten-password-request
Request a password reset link be sent to the member’s registered email.
documented - Get login tokenGET /auth/get-login-token
Generate a single-use login token for the current member to sign into Letterboxd.
documented - Get upload URLGET /auth/get-upload-url
Generate a one-time upload URL for the current member to upload a data file.
documented