The RealReal API endpoint
Returns a page of The RealReal listings browsed by designer slug, e.g. gucci. Pass a previous response's next_after back as after to fetch the next page.
/therealreal/designerQuery parameters:
slug (required) — designer slug, from the
designers endpoint's slug field.on_sale (optional) — when true, only return items currently marked
down from their original price.available (optional) — when true, only return items currently
available to purchase (excludes sold and waitlisted items).after (optional) — an opaque pagination cursor from a previous
response's next_after. Omit for the first page.Notable response behavior:
total,
has_more, next_after, listings.slug returns 404.| Field | Filled in, of 120 checked | Values in the sample |
|---|---|---|
| id | 120 | |
| name | 120 | “Silk Mini Dress” and 104 other values |
| sku | 120 | |
| designer | 120 | Gucci in all 120 |
| condition | 120 | Very Good (46), Good (34), Excellent (19) and 2 more |
| color | 119 | “Orange” and 11 other values |
| gender | 108 | |
| price_usd | 120 | 115 to 2,400, median 525 |
| original_price_usd | 120 | 115 to 2,400, median 525 |
| available | 120 | true in 117 of 120 |
| image_url | 120 | product-images.therealreal.com |
| images | 120 | median 5 entries |
| url | 120 | therealreal.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug | string | Yes | Designer slug, from the designers endpoint's slug field | gucci | |
| 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 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/therealreal/designer?slug=gucci&on_sale=true&available=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total": 146120,
"has_more": true,
"next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
"listings": [
{
"id": "54388579",
"name": "GG Marmont Small Shoulder Bag",
"designer": "Gucci",
"condition": "Excellent",
"price_usd": 950,
"original_price_usd": 1980,
"available": true,
"url": "https://www.therealreal.com/products/women/handbags/shoulder-bags/gucci-gg-marmont-small-shoulder-bag-abcde"
}
],
"source_url": "https://www.therealreal.com/designers/gucci"
}
}Request schema
No body schema
Response schema
#/definitions/therealreal.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | therealreal.ProductsResponse | No | ||||
| data.has_more | boolean | No | true | |||
| data.listings | array | No | Listing record, 15 fields: available, color, condition, designer, designer_slug, gender, id, image_url, images, name, original_price_usd, price_usd and 3 more. Described under The RealReal search API. | |||
| data.next_after | string | No | YXJyYXljb25uZWN0aW9uOjExOQ== | |||
| data.source_url | string | No | ||||
| data.total | integer | No | 404167 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/therealreal/designer?slug=gucci&on_sale=true&available=true" \
-H "x-api-key: $CRAWLORA_API_KEY"