---
title: "Get films similar to a Letterboxd film"
method: GET
path: "/letterboxd/film/{slug}/similar"
tags: ["Letterboxd"]
---

# Get films similar to a Letterboxd film

`GET /letterboxd/film/{slug}/similar`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/letterboxd/film/{slug}/similar`
- Auth: API key in header `x-api-key`

Lists films Letterboxd recommends as similar to the film given by `slug`, up to `limit` (default 10, max 50). Each film has its `slug`, title and Letterboxd URL. Use the slug to look up that film's details.

## Path parameters

- `slug` string, required

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- LetterboxdSimilarResponseDoc
  - `code` integer
  - `data` LetterboxdSimilarResponse
    - `films` LetterboxdFilmRef[]: Films Letterboxd lists as similar.
      - `slug` string: Letterboxd film slug. Use it with the film endpoint for full detail.
      - `title` string: Title of the film.
      - `uri` string: Link to the film's page on Letterboxd.
    - `slug` string: Slug of the film the similar films are for.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)