Docs menu

The RealReal API endpoint

The RealReal listing detail API

Returns a single The RealReal listing: description, condition detail, category context, and measurements, plus the shared summary fields (name, designer, condition, price, images). Looked up by the listing's full product URL, as returned in a search/category/designer response's url field.

GETapiKey4 credits/requestThe RealRealtherealreal.listingResponseDoc/therealreal/listing

Endpoint facts

Method: GET
API path: /therealreal/listing
Auth: apiKey
Credits: 4 credits/request
Charged on: Successful 2xx responses only
Platform: The RealReal
Response schema: #/definitions/therealreal.listingResponseDoc

The RealReal Scraper API Try The RealReal listing detail API in Playground The RealReal API documentation

How this endpoint behaves

Query parameters:

url (required) — full product URL, e.g. https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu. The RealReal's listing URLs are opaque slugs with no separate short numeric-id lookup route, so the full URL is the only reliable lookup key.

Notable response behavior:

A url that isn't a therealreal.com /products/... listing URL returns 400.
An unrecognized listing URL returns 404.

Live monitoring

Monitored request: GET /therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 1.92 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu
Fields returned with a value: 19

Field	In the sample	Value in the sample
id	Has a value
name	Has a value	“Denim Pearl Crush Wallet On Chain”
sku	Has a value
designer	Has a value	“Chanel”
designer_slug	Has a value
condition	Has a value	“Very Good”
color	Has a value	“Blue”
gender	Has a value
price_usd	Has a value	3,800
original_price_usd	Has a value	3,800
available	Has a value	false
image_url	Has a value	product-images.therealreal.com
images	Has a value	4 entries
url	Has a value	therealreal.com
description	Has a value	263 characters
condition_detail	Has a value	“Minor discoloration throughout; minor discoloration at hard…”
category_name	Has a value	“Women”
category_label	Has a value	“Women's Fashion & Accessories”
measurements	Has a value

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Full product URL, as returned in a search/category/designer response's url field	https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "images": [
      "https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg",
      "https://product-images.therealreal.com/CHA1494621_2_enlarged.jpg"
    ],
    "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu",
    "description": "Chanel Crossbody Bag, Blue Denim, Tweed Pattern...",
    "condition_detail": "Minor discoloration throughout; minor discoloration at hardware; minor scuff at corner.",
    "category_name": "Women",
    "category_label": "Women's Fashion & Accessories",
    "measurements": {
      "Height": "5\"",
      "Width": "7.5\"",
      "Shoulder Strap Drop": "19\""
    },
    "source_url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
  }
}

Request schema

No body schema

Response schema

#/definitions/therealreal.listingResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	therealreal.ListingDetail	No
data.available	boolean	No	true
data.category_label	string	No	Women's Fashion & Accessories
data.category_name	string	No	Women
data.color	string	No	Blue
data.condition	string	No	Very Good
data.condition_detail	string	No	Minor discoloration throughout; minor discoloration at hardware; minor scuff at corner.
data.description	string	No
data.designer	string	No	Chanel
data.designer_slug	string	No	chanel
data.gender	string	No	Women
data.id	string	No	54388578
data.image_url	string	No	https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg
data.images	array	No
data.measurements	object	No
data.name	string	No	Denim Pearl Crush Wallet On Chain
data.original_price_usd	number	No	3800
data.price_usd	number	No	3800
data.sku	string	No	CHA1494621
data.source_url	string	No
data.url	string	No	https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu
data.waitlisted	boolean	No	false
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More The RealReal endpoint docs The RealReal Scraper API The RealReal search-box suggestions API documentation The RealReal category taxonomy API documentation The RealReal category browse API documentation The RealReal collection browse API documentation The RealReal Collections API documentation The RealReal Condition Scale API documentation

Open in Playground Back to group

Docs menu

The RealReal API endpoint

The RealReal listing detail API

GETapiKey4 credits/requestThe RealRealtherealreal.listingResponseDoc/therealreal/listing

Endpoint facts

Method: GET
API path: /therealreal/listing
Auth: apiKey
Credits: 4 credits/request
Charged on: Successful 2xx responses only
Platform: The RealReal
Response schema: #/definitions/therealreal.listingResponseDoc

The RealReal Scraper API Try The RealReal listing detail API in Playground The RealReal API documentation

How this endpoint behaves

Query parameters:

url (required) — full product URL, e.g. https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu. The RealReal's listing URLs are opaque slugs with no separate short numeric-id lookup route, so the full URL is the only reliable lookup key.

Notable response behavior:

A url that isn't a therealreal.com /products/... listing URL returns 400.
An unrecognized listing URL returns 404.

Live monitoring

Monitored request: GET /therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 1.92 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu
Fields returned with a value: 19

Field	In the sample	Value in the sample
id	Has a value
name	Has a value	“Denim Pearl Crush Wallet On Chain”
sku	Has a value
designer	Has a value	“Chanel”
designer_slug	Has a value
condition	Has a value	“Very Good”
color	Has a value	“Blue”
gender	Has a value
price_usd	Has a value	3,800
original_price_usd	Has a value	3,800
available	Has a value	false
image_url	Has a value	product-images.therealreal.com
images	Has a value	4 entries
url	Has a value	therealreal.com
description	Has a value	263 characters
condition_detail	Has a value	“Minor discoloration throughout; minor discoloration at hard…”
category_name	Has a value	“Women”
category_label	Has a value	“Women's Fashion & Accessories”
measurements	Has a value

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Full product URL, as returned in a search/category/designer response's url field	https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "images": [
      "https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg",
      "https://product-images.therealreal.com/CHA1494621_2_enlarged.jpg"
    ],
    "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu",
    "description": "Chanel Crossbody Bag, Blue Denim, Tweed Pattern...",
    "condition_detail": "Minor discoloration throughout; minor discoloration at hardware; minor scuff at corner.",
    "category_name": "Women",
    "category_label": "Women's Fashion & Accessories",
    "measurements": {
      "Height": "5\"",
      "Width": "7.5\"",
      "Shoulder Strap Drop": "19\""
    },
    "source_url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
  }
}

Request schema

No body schema

Response schema

#/definitions/therealreal.listingResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	therealreal.ListingDetail	No
data.available	boolean	No	true
data.category_label	string	No	Women's Fashion & Accessories
data.category_name	string	No	Women
data.color	string	No	Blue
data.condition	string	No	Very Good
data.condition_detail	string	No	Minor discoloration throughout; minor discoloration at hardware; minor scuff at corner.
data.description	string	No
data.designer	string	No	Chanel
data.designer_slug	string	No	chanel
data.gender	string	No	Women
data.id	string	No	54388578
data.image_url	string	No	https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg
data.images	array	No
data.measurements	object	No
data.name	string	No	Denim Pearl Crush Wallet On Chain
data.original_price_usd	number	No	3800
data.price_usd	number	No	3800
data.sku	string	No	CHA1494621
data.source_url	string	No
data.url	string	No	https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu
data.waitlisted	boolean	No	false
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

The RealReal listing detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

The RealReal listing detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related