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

[APIs](https://perceptlayer.com/apis) / [thredUP](https://perceptlayer.com/apis/thredup) / Search

# thredUP: Search

Search from thredUP as JSON. 1 credit per successful call.

GET `/v1/thredup/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | Optional | Up to 200 characters |
| `department` | string | Optional | women, girls, boys |
| `category` | string | Optional | Any |
| `brand_id[]` | list of integer | Optional | Any |
| `size_id[]` | list of integer | Optional | Any |
| `condition[]` | list of string | Optional | excellent, very-good, good, flawed-gems |
| `color[]` | list of string | Optional | Any |
| `price_min` | number | Optional | Any |
| `price_max` | number | Optional | Any |
| `sort` | string | Optional | recommended, relevance, newest\_first, price\_low\_high, price\_high\_low, marked\_down\_at\_desc |
| `page` | integer | Optional | Any |
| `per_page` | integer | Optional | Any |

## Example request

thredUP

GET /v1/thredup/search?query=gucci+bag&department=women&price\_max=500 

```
{
  "success": true,
  "items": [
    {
      "id": 236840087,
      "item_number": 237788067,
      "title": "Coach Factory Leather Hobo",
      "url": "https://www.thredup.com/product/women-coach-factory-coach-factory-leather-hobo/237788067",
      "brand": "Coach Factory",
      "brand_id": 31047,
      "category": "handbags",
      "category_tags": [
        "handbags"
      ],
      "department_tags": [
        "handbags",
        "women"
      ],
      "gender": "women",
      "colors": [
        "Pink"
      ],
      "materials": [
        "100% Leather"
      ],
      "size": {
        "label": "One size",
        "size_ids": [
          902
        ]
      },
      "condition": {
        "label": "Flawed gem",
        "value": "flawed-gems",
        "new_with_tags": false
      },
      "price": 149.99,
      "original_price": 404,
      "msrp": 404,
      "currency": "USD",
      "discount_percent": 62.9,
      "clearance": false,
      "final_sale": true,
      "is_peer_to_peer": false,
      "availability": "InStock",
      "state": "listed",
      "favorite_count": 47,
      "style_tags": [
        "hobos"
      ],
      "description": "Soft pink leather shoulder bag with gathered detail and silver hardware",
      "images": [
        "https://cf-assets-thredup.thredup.com/assets/974818564/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/978941651/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/974818722/xlarge.jpg"
      ]
    },
    {
      "id": 237793017,
      "item_number": 238670020,
      "title": "Coach Factory Tote",
      "url": "https://www.thredup.com/product/women-coach-factory-coach-factory-tote/238670020",
      "brand": "Coach Factory",
      "brand_id": 31047,
      "category": "handbags",
      "category_tags": [
        "handbags"
      ],
      "department_tags": [
        "handbags",
        "women"
      ],
      "gender": "women",
      "colors": [
        "Gray"
      ],
      "materials": [
        "No Fabric Content"
      ],
      "size": {
        "label": "One size",
        "size_ids": [
          902
        ]
      },
      "condition": {
        "label": "Flawed gem",
        "value": "flawed-gems",
        "new_with_tags": false
      },
      "price": 151.99,
      "original_price": 190,
      "msrp": 190,
      "currency": "USD",
      "discount_percent": 20,
      "clearance": false,
      "final_sale": true,
      "is_peer_to_peer": false,
      "availability": "InStock",
      "state": "listed",
      "favorite_count": 47,
      "style_tags": [
        "totes"
      ],
      "description": "Tote bag with a black and tan Coach signature canvas pattern and leather trim, featuring two shoulder straps and a silver logo emblem",
      "images": [
        "https://cf-assets-thredup.thredup.com/assets/980763255/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/980747107/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/980763274/xlarge.jpg"
      ]
    },
    {
      "id": 238946055,
      "item_number": 239742403,
      "title": "Coach Factory Leather Satchel",
      "url": "https://www.thredup.com/product/women-coach-factory-coach-factory-leather-satchel/239742403",
      "brand": "Coach Factory",
      "brand_id": 31047,
      "category": "handbags",
      "category_tags": [
        "handbags"
      ],
      "department_tags": [
        "handbags",
        "women"
      ],
      "gender": "women",
      "colors": [
        "Ivory"
      ],
      "materials": [
        "100% Leather"
      ],
      "size": {
        "label": "One size",
        "size_ids": [
          902
        ]
      },
      "condition": {
        "label": "Good",
        "value": "good",
        "new_with_tags": false
      },
      "price": 152.99,
      "original_price": 404,
      "msrp": 404,
      "currency": "USD",
      "discount_percent": 62.1,
      "clearance": false,
      "final_sale": true,
      "is_peer_to_peer": false,
      "availability": "InStock",
      "state": "listed",
      "favorite_count": 13,
      "style_tags": [
        "satchels"
      ],
      "description": "Light beige leather tote bag with adjustable shoulder strap and luggage tag",
      "images": [
        "https://cf-assets-thredup.thredup.com/assets/986309475/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/986235732/xlarge.jpg",
        "https://cf-assets-thredup.thredup.com/assets/986309580/xlarge.jpg"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 40,
    "total": 10001,
    "returned": 40,
    "filtered_out": 0,
    "has_next_page": true
  },
  "filters_applied": {
    "query": "gucci bag",
    "department": "women",
    "price_max": "500",
    "sort": "recommended"
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_3d0f25070375427c8e5bce92cbb9d614",
    "credits_charged": 1,
    "credits_remaining": 1913
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

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