---
title: "The RealReal API: Search | Perceptlayer"
description: "Search from The RealReal as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/therealreal/search
---

[APIs](https://perceptlayer.com/apis) / [The RealReal](https://perceptlayer.com/apis/therealreal) / Search

# 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/therealreal?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.