Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / thredUP

1 credit per call2 endpoints28 datapoints

thredUP API

thredUP API for second-hand clothing search by brand, size, condition and price, with MSRP, discounts and product details as JSON. 1 credit per successful call.

Get a free API keyRun it below
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.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegeritem_numberintegertitlestringurlurlbrandstringbrand_idintegercategorystringcategory_tagsstring[]department_tagsstring[]genderstringcolorsstring[]materialsstring[]sizeobjectconditionobjectpricenumberoriginal_priceintegermsrpintegercurrencystringdiscount_percentnumberclearancebooleanfinal_salebooleanis_peer_to_peerbooleanavailabilitystringstatestringfavorite_countintegerstyle_tagsstring[]descriptionstringimagesstring[]
1236840087237788067Coach Factory Leather Hobohttps://www.thredup.com/product/women-coach-factory-coach-factory-leather-hobo/237788067Coach Factory31047handbags[1 item][2 items]women[1 item][1 item]{2 fields}{3 fields}149.99404404USD62.9falsetruefalseInStocklisted47[1 item]Soft pink leather shoulder bag with gathered detail and silver hardware[3 items]
2237793017238670020Coach Factory Totehttps://www.thredup.com/product/women-coach-factory-coach-factory-tote/238670020Coach Factory31047handbags[1 item][2 items]women[1 item][1 item]{2 fields}{3 fields}151.99190190USD20falsetruefalseInStocklisted47[1 item]Tote bag with a black and tan Coach signature canvas pattern and leather trim, featuring two shoulder straps and a silver logo emblem[3 items]
3238946055239742403Coach Factory Leather Satchelhttps://www.thredup.com/product/women-coach-factory-coach-factory-leather-satchel/239742403Coach Factory31047handbags[1 item][2 items]women[1 item][1 item]{2 fields}{3 fields}152.99404404USD62.1falsetruefalseInStocklisted13[1 item]Light beige leather tote bag with adjustable shoulder strap and luggage tag[3 items]

Recorded from our API · 3 items shown · 28 datapoints per itemGET /v1/thredup/search?query=gucci+bag&department=women&price_max=500

28 datapoints

Identity

  • idinteger
  • titlestring
  • brandstring
  • brand_idinteger
  • categorystring
  • category_tagsstring[]

Contact

  • urlurl

Location

  • statestring

Reputation

  • imagesstring[]

Price

  • pricenumber
  • original_priceinteger
  • currencystring
  • discount_percentnumber

Other

  • item_numberinteger
  • department_tagsstring[]
  • genderstring
  • colorsstring[]
  • materialsstring[]
  • sizeobject
  • conditionobject
  • msrpinteger
  • clearanceboolean
  • final_saleboolean
  • is_peer_to_peerboolean
  • availabilitystring
  • favorite_countinteger
  • style_tagsstring[]
  • descriptionstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/thredup/search?query=gucci+bag&department=women&price_max=500" \
  -H "X-API-Key: $API_KEY"

thredUP · 2 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/thredup/product
none+2 optional
1 credit
GET/v1/thredup/search
none+12 optional
1 credit

Overview

What you can get

The thredUP API returns thredUP resale data as JSON through 2 endpoints.

  • Search: search takes a query, with department (women, girls or boys), category, price_min, price_max, sort (recommended, relevance, newest_first, price_low_high, price_high_low or marked_down_at_desc), page and per_page. brand_id[], size_id[] and color[] are repeatable; condition[] is repeatable and takes excellent, very-good, good or flawed-gems.
  • Products: product takes an item_number or a url.

The recorded search for "gucci bag" with department=women and price_max=500 returns items, each with id, item_number, title, url, brand, brand_id, category, colors, materials, size, condition, price, original_price, msrp, discount_percent, clearance, final_sale, availability, favorite_count and images. It also returns pagination with has_next_page, and filters_applied.

How a call works

Search, then look up: GET /v1/thredup/search?query=gucci bag&department=women&price_max=500 with your key in the X-API-Key header. Each result carries an item_number, which product takes, and a brand_id, which brand_id[] takes to search one brand. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track second-hand prices for a brand against its `msrp`

Use the thredUP API to track second-hand prices for a brand against its `msrp`

Find markdowns with `sort=marked_down_at_desc`

Use the thredUP API to find markdowns with `sort=marked_down_at_desc`

Compare prices by condition, from excellent to flawed-gems

Use the thredUP API to compare prices by condition, from excellent to flawed-gems

Watch new listings for a brand with `sort=newest_first`

Use the thredUP API to watch new listings for a brand with `sort=newest_first`

FAQ

Questions

How much does the thredUP API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I search one brand?

Yes. Take a `brand_id` from a search result and pass it as `brand_id[]`, which is repeatable.

Do I need a thredUP account?

No. You call this thredUP API with your Perceptlayer key in the `X-API-Key` header, with no thredUP login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a thredUP scraper instead?

You can, but a thredUP scraper is code you maintain: page changes break it, requests get blocked, and thredUP's terms govern how you collect data. The thredUP API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the thredUP API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs