The RealReal Item API Documentation Read one The RealReal item. Send the product url to get everything of a search row plus description and detail bullets, condition and condition notes, colors, category path, measurements in inches, return policy and authentication text. Send only a SKU to get the search row of that SKU without description and measurements. A url or SKU lookup costs 1 credit. A sold or removed item answers 404. A 404 and a failed request are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
2 optional filters available.
string
Optional
A therealreal.com product url, e.g. the url of a search row. Required unless you send a SKU. Gives the full item.
https://example.com/product
string
Optional
The SKU of a search row, e.g. GUC2188017. Required unless you send a url. Gives the search row only.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
item
meta
success
{
"item": {
"id": "55945611",
"sku": "GUC2188017",
"url": "https://www.therealreal.com/products/women/handbags/handle-bags/gucci-gg-signature-sukey-medium-xb3wr",
"msrp": null,
"name": "GG Signature Sukey Medium",
"sold": false,
"badge": null,
"brand": "Gucci",
"price": 365,
"colors": [
"Neutrals",
"Pattern Prints"
],
"gender": "Women",
"images": [
"https://product-images.therealreal.com/GUC2188017_1_enlarged.jpg",
"https://product-images.therealreal.com/GUC2188017_2_enlarged.jpg"
],
"details": [
"Gucci Top Handle Bag",
"By Frida Giannini",
"Neutrals Leather",
"Patterned",
"GG Signature & Sukey Logo",
"Gold-Tone Hardware",
"Rolled Handles & Single Adjustable Shoulder Strap",
"Leather Trim Embellishment",
"Canvas Lining & Three Interior Pockets",
"Zip Closure at Top"
],
"category": "Women",
"currency": "USD",
"quantity": 1,
"available": true,
"condition": "Good",
"favorites": 0,
"final_sale": true,
"description": "- Gucci Top Handle Bag\n- By Frida Giannini\n- Neutrals Leather\n- Patterned\n- GG Signature & Sukey Logo\n- Gold-Tone Hardware\n- Rolled Handles & Single Adjustable Shoulder Strap\n- Leather Trim Embellishment\n- Canvas Lining & Three Interior Pockets\n- Zip Closure at Top\nUnfortunately, due to restrictions, this item may not be eligible for shipping in all areas.",
"designer_id": "544",
"availability": "available",
"measurements": [
{
"name": "Shoulder Strap Drop",
"text": "19.75\"",
"unit": "in",
"value": 19.75
},
{
"name": "Handle Drop",
"text": "5.75\"",
"unit": "in",
"value": 5.75
},
{
"name": "Height",
"text": "10.5\"",
"unit": "in",
"value": 10.5
},
{
"name": "Width",
"text": "12.75\"",
"unit": "in",
"value": 12.75
},
{
"name": "Depth",
"text": "4.5\"",
"unit": "in",
"value": 4.5
}
],
"category_path": [
{
"id": "1500",
"name": "All Handle Bags",
"path": "women/handbags/handle-bags/all-handle-bags"
},
{
"id": "545",
"name": "Handle Bags",
"path": "women/handbags/handle-bags"
},
{
"id": "493",
"name": "Handbags",
"path": "women/handbags"
},
{
"id": "329",
"name": "Women",
"path": "women"
}
],
"return_policy": {
"text": "This item is final sale and is not returnable.",
"returnable": false
},
"authentication": [
"We authenticate every item with a rigorous process overseen by experts. Learn more & see our authentication process.",
"Photos are of the actual product."
],
"original_price": 365,
"condition_notes": [
"Moderate discoloration throughout"
],
"discount_percent": null,
"discount_percent_vs_msrp": null
},
"meta": {
"source": "item_page",
"credits": 3,
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"url": [
"Send a product url or a SKU."
]
},
"message": "The request validation failed"
}Item Not Found
The RealReal has no item for this request. It may be sold or removed. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The RealReal has no item for this request. It may be sold or removed."
},
"success": false
}Source Unavailable
The RealReal did not give a usable answer after the retries. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "upstream_unavailable",
"message": "The RealReal is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.