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 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.