Endpoint Playground
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.
14 Oct 2026: 120 listings; 12 fields had a value in every checked item.
Sample value profiles: condition: Good (38), Fair (26), As Is (19) and 3 more; price_usd: 126 to 6,400, median 436; name: “GG Canvas Shoulder Bag” and 98 other values.
curl 'https://api.crawlora.net/api/v1/therealreal/search?query=gucci+bag' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | gucci bag | Free-text keyword search |
| category_id | string | No | Category (taxon) id, from the categories endpoint's id field | |
| designer_id | string | No | Designer id, from the designers endpoint's id field | |
| condition_id | string | No | Condition grade id, from the conditions endpoint's id field | |
| price_from | number | No | Minimum price in USD | |
| price_to | number | No | Maximum price in USD | |
| on_sale | boolean | No | Only return items currently marked down from their original price | |
| available | boolean | No | Only return items currently available to purchase (excludes sold and waitlisted items) | |
| after | string | No | Opaque pagination cursor from a previous response's next_after. Omit for the first page |
{
"code": 200,
"msg": "OK",
"data": {
"total": 3643,
"has_more": true,
"next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
"listings": [
{
"id": "54388578",
"name": "Denim Pearl Crush Wallet On Chain",
"sku": "CHA1494621",
"designer": "Chanel",
"designer_slug": "chanel",
"condition": "Very Good",
"color": "Blue",
"gender": "Women",
"price_usd": 3800,
"original_price_usd": 3800,
"available": true,
"image_url": "https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg",
"url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
}
],
"source_url": "https://www.therealreal.com/products?keywords=bag"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.