The RealReal

Search The RealReal luxury consignment listings

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.

get/therealreal/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/therealreal/search
  • Auth: API key in header x-api-key

Query parameters

querystring required

Free-text keyword search

category_idstring

Category (taxon) id, from the categories endpoint's id field

designer_idstring

Designer id, from the designers endpoint's id field

condition_idstring

Condition grade id, from the conditions endpoint's id field

price_fromnumber

Minimum price in USD

price_tonumber

Maximum price in USD

on_saleboolean

Only return items currently marked down from their original price

availableboolean

Only return items currently available to purchase (excludes sold and waitlisted items)

afterstring

Opaque pagination cursor from a previous response's next_after. Omit for the first page

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "has_more": true,
    "listings": [
      {
        "available": true,
        "color": "Blue",
        "condition": "Very Good",
        "designer": "Chanel",
        "designer_slug": "chanel",
        "gender": "Women",
        "id": "54388578",
        "image_url": "https://product-images.therealreal.com/CHA1494621_1_enlarged.jpg",
        "name": "Denim Pearl Crush Wallet On Chain",
        "original_price_usd": 3800,
        "price_usd": 3800,
        "sku": "CHA1494621",
        "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
      }
    ],
    "next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
    "total": 404167
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.