The RealReal API endpoint
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).
/therealreal/similarQuery parameters:
product_id (required) — The RealReal numeric product id, from a
search/category/
designer/listing/
collection response's id field.Notable response behavior:
product_id must be numeric; a non-numeric value returns 400 before
any upstream request is made.| Field | Filled in, of 14 checked | Values in the sample |
|---|---|---|
| id | 14 | |
| name | 14 | “Denim Pearl Crush Wallet On Chain” and 12 other values |
| sku | 14 | |
| designer | 14 | Chanel in all 14 |
| designer_slug | 14 | |
| price_usd | 14 | 2,166.5 to 8,000, median 3,905.75 |
| original_price_usd | 14 | 2,645 to 8,000, median 4,000 |
| available | 14 | true in 14 of 14 |
| image_url | 14 | product-images.therealreal.com |
| images | 14 | median 6 entries |
| url | 14 | therealreal.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| product_id | string | Yes | The RealReal numeric product id, from a search/category/designer/listing/collection response's id field | 54388578 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/therealreal/similar?product_id=54388578" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"listings": [
{
"id": "47942591",
"name": "Shadow Denim Wallet On Chain",
"sku": "CHA1343119",
"designer": "Chanel",
"designer_slug": "chanel",
"price_usd": 3127.5,
"original_price_usd": 3475,
"available": true,
"image_url": "https://product-images.therealreal.com/CHA1343119_1_enlarged.jpg",
"url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-shadow-denim-wallet-on-chain-sjkqn"
}
],
"source_url": "https://api.therealreal.com/graphql"
}
}Request schema
No body schema
Response schema
#/definitions/therealreal.similarResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | therealreal.SimilarResponse | No | ||||
| 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.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/similar?product_id=54388578" \
-H "x-api-key: $CRAWLORA_API_KEY"