The RealReal

Browse The RealReal listings by category

Returns a page of The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page.

get/therealreal/category

Request

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

Query parameters

pathstring required

Category permalink path, from the categories endpoint's permalink field

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.