therealreal_search
Search authenticated luxury resale listings by keyword with optional filters for designer, category, condition, and price, returning normalized item summaries plus a pagination cursor.
Instructions
Search The RealReal luxury consignment listings. Searches The RealReal's authenticated luxury resale catalog by keyword, optionally combined with category, designer, condition-grade, and price-range filters, returning normalized 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. Credential-free public data sourced from The RealReal's own server-rendered search page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Opaque pagination cursor from a previous response's next_after. Omit for the first page | |
| query | Yes | Free-text keyword search | |
| on_sale | No | Only return items currently marked down from their original price | |
| price_to | No | Maximum price in USD | |
| available | No | Only return items currently available to purchase (excludes sold and waitlisted items) | |
| price_from | No | Minimum price in USD | |
| category_id | No | Category (taxon) id, from the categories endpoint's id field | |
| designer_id | No | Designer id, from the designers endpoint's id field | |
| condition_id | No | Condition grade id, from the conditions endpoint's id field |