---
title: "Get The RealReal similar-item recommendations"
method: GET
path: "/therealreal/similar"
tags: ["The RealReal"]
---

# Get The RealReal similar-item recommendations

`GET /therealreal/similar`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/therealreal/similar`
- Auth: API key in header `x-api-key`

Returns The RealReal's own "Similar Items" visual-similarity recommendations for one product, looked up by the product's numeric id (from any other The RealReal endpoint's listing response id field).

## Query parameters

- `product_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TherealrealSimilarResponseDoc
  - `code` integer
  - `data` TherealrealSimilarResponse
    - `listings` TherealrealListing[]
      - `available` boolean
      - `color` string
      - `condition` string
      - `designer` string
      - `designer_slug` string
      - `gender` string
      - `id` string
      - `image_url` string
      - `images` string[]
      - `name` string
      - `original_price_usd` number
      - `price_usd` number
      - `sku` string
      - `url` string
      - `waitlisted` boolean
    - `source_url` string
  - `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/afac9b012a27?raw)