The RealReal: Search

Search from The RealReal as JSON. 1 credit per successful call.

GET /v1/therealreal/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`query`	string	Optional	Up to 200 characters
`category`	string	Optional	Up to 120 characters
`designer[]`	list of integer	Optional	Any
`color[]`	list of integer	Optional	Any
`clothing_size[]`	list of integer	Optional	Any
`shoe_size[]`	list of integer	Optional	Any
`taxon_id[]`	list of integer	Optional	Any
`condition[]`	list of string	Optional	pristine, excellent, very-good, good, fair, as-is
`price_min`	number	Optional	Any
`price_max`	number	Optional	Any
`on_sale`	boolean	Optional	Any
`with_tags`	boolean	Optional	Any
`vintage`	boolean	Optional	Any
`editors_picks`	boolean	Optional	Any
`page`	integer	Optional	Any

Example request

The RealReal

GET/v1/therealreal/search?query=gucci+bag&condition[]=very-good&price_max=500

{
  "success": true,
  "items": [
    {
      "id": "55468756",
      "sku": "GUC2174252",
      "name": "GG Canvas Joy",
      "url": "https://www.therealreal.com/products/women/handbags/totes/gucci-gg-canvas-joy-x0vys",
      "brand": "Gucci",
      "designer_id": "544",
      "price": 400,
      "original_price": 500,
      "currency": "USD",
      "discount_percent": 20,
      "availability": "available",
      "available": true,
      "sold": false,
      "quantity": 1,
      "condition": "Very Good",
      "gender": "Women",
      "favorites": 3,
      "images": [
        "https://product-images.therealreal.com/GUC2174252_1_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2174252_2_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2174252_3_enlarged.jpg"
      ]
    },
    {
      "id": "55333848",
      "sku": "GUC2169717",
      "name": "Nylon Shoulder Bag",
      "url": "https://www.therealreal.com/products/women/handbags/shoulder-bags/gucci-nylon-shoulder-bag-wxzvc",
      "brand": "Gucci",
      "designer_id": "544",
      "price": 380,
      "original_price": 475,
      "currency": "USD",
      "discount_percent": 20,
      "availability": "available",
      "available": true,
      "sold": false,
      "quantity": 1,
      "condition": "Very Good",
      "gender": "Women",
      "favorites": 4,
      "images": [
        "https://product-images.therealreal.com/GUC2169717_1_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2169717_2_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2169717_3_enlarged.jpg"
      ]
    },
    {
      "id": "55333672",
      "sku": "GUC2169709",
      "name": "Nylon Crossbody Bag",
      "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/gucci-nylon-crossbody-bag-wxzqg",
      "brand": "Gucci",
      "designer_id": "544",
      "price": 360,
      "original_price": 450,
      "currency": "USD",
      "discount_percent": 20,
      "availability": "available",
      "available": true,
      "sold": false,
      "quantity": 1,
      "condition": "Very Good",
      "gender": "Women",
      "favorites": 4,
      "images": [
        "https://product-images.therealreal.com/GUC2169709_1_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2169709_2_enlarged.jpg",
        "https://product-images.therealreal.com/GUC2169709_3_enlarged.jpg"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 120,
    "total": 7825,
    "reachable": 2000,
    "returned": 120,
    "filtered_out": 0,
    "has_next_page": true
  },
  "facets": [
    {
      "name": "Categories",
      "parameter": "taxon_id",
      "buckets": [
        {
          "id": "329",
          "name": "Women",
          "count": 6457,
          "path": "women"
        },
        {
          "id": "495",
          "name": "Accessories",
          "count": 1365,
          "path": "women/accessories"
        },
        {
          "id": "1603",
          "name": "Bag Accessories",
          "count": 36,
          "path": "women/accessories/bag-accessories"
        }
      ]
    },
    {
      "name": "Clothing Sizes",
      "parameter": "clothing_size",
      "buckets": [
        {
          "id": "22",
          "name": "Petite",
          "count": 2
        },
        {
          "id": "23",
          "name": "XXS",
          "count": 26
        },
        {
          "id": "24",
          "name": "XS",
          "count": 223
        }
      ]
    },
    {
      "name": "Shoe Sizes",
      "parameter": "shoe_size",
      "buckets": [
        {
          "id": "30",
          "name": "4",
          "count": 14
        },
        {
          "id": "31",
          "name": "4.5",
          "count": 9
        },
        {
          "id": "32",
          "name": "5",
          "count": 51
        }
      ]
    }
  ],
  "filters_applied": {
    "query": "gucci bag",
    "price_max": "500",
    "condition": [
      "very-good"
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_f1d4cacfe7514a8fa434c2097fd27d25",
    "credits_charged": 1,
    "credits_remaining": 1901
  }
}

200 OKJSONX-Credits-Used: 1

Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.