---
title: "Search The RealReal luxury consignment listings"
method: GET
path: "/therealreal/search"
tags: ["The RealReal"]
---

# Search The RealReal luxury consignment listings

`GET /therealreal/search`

## Request

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

Searches The RealReal's authenticated luxury resale catalog by keyword, optionally combined with category, designer, condition-grade, and price-range filters, returning listing summaries (name, designer, condition, price, images) plus the total matching count and an opaque pagination cursor. Pass a previous response's next_after back as after to fetch the next page.

## Query parameters

- `query` string, required
- `category_id` string
- `designer_id` string
- `condition_id` string
- `price_from` number
- `price_to` number
- `on_sale` boolean
- `available` boolean
- `after` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TherealrealSearchResponseDoc
  - `code` integer
  - `data` TherealrealProductsResponse
    - `has_more` boolean
    - `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
    - `next_after` string
    - `source_url` string
    - `total` integer
  - `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/0497899e2016?raw)