thredUP
thredUP Deals API
thredUP's deal collections on thredup.com (thredUP's US store, USD): clearance, under_10 (thredUP's Under $10 range), new_arrivals (newest first) and price_drops (recently discounted first), in a department (women by default) with the usual brand, category, size, condition, colour, material, pattern, price and seller-type filters. Each item with price, the estimated original retail and percent off, clearance and final-sale flags. 119 items per page, up to page 21. Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncollectionenum<string>requiredWhich deal collection.
Example: clearance
clearance— Clearance items.under_10— thredUP's Under $10 range, matched on the base price (sets the price range itself).new_arrivals— Newest first (a sort of its own).price_drops— Recently discounted first (a sort of its own).
departmentenum<string>default:womenDepartment: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity, accessories. thredUP has no men's department.
Example: handbags
brandstringOne brand as thredUP writes it (items[].brand, brands[].brand, suggestions[].brand). "<Brand> - all brands" covers a brand's sub-lines.
Example: Madewell
categorystringA category tag from categories (categories[].category: dresses, tops, outerwear, jeans, one-pieces ...).
Example: outerwear
pageintegerdefault:1Page, 1 to 21, 119 items each (about 2,500 items per query and filter combination).
Example: 2
sortenum<string>default:defaultResult order, for clearance and under_10 only (new_arrivals and price_drops are sorts themselves).
Example: price_low
default— thredUP's own order for the page: relevance for a search, recommended for a list, recently discounted for sold.recommended— thredUP's recommended order.relevance— Best match to the query first.newest— Newest first.price_low— Price low to high.price_high— Price high to low.price_drop— Recently discounted first.
sizeinteger | integer[]Sizing ids from categories (sizes[].size: 778 is Sm in women's), up to 10. Ids, not labels.
Example: [778]
conditionstring | string[]Up to 5 conditions.
Example: ["excellent"]
new_with_tags— Original tags attached.excellent— Excellent.very_good— Very good.good— Good.flawed— thredUP's Flawed Gems.
colorstring | string[]Up to 5 colours: black, grey, white, ivory, tan, brown, purple, blue, teal, green, red, pink, orange, yellow.
Example: ["black"]
materialstring | string[]Up to 5 material groups: natural, cashmere, cotton, linen, silk, wool, leather, suede, blend, cashmere blend, cotton blend, linen blend, silk blend, wool blend, synthetic, acrylic, faux fur, nylon, polyester, rayon, spandex, vegan leather.
Example: ["cotton"]
patternstringOne pattern: animal print, argyle, camo, checkered-gingham, chevron-herringbone, color block, floral, graphic, hearts, houndstooth, metallic, paisley, plaid, polka dots, print, solid, stars, stripes, tie-dye, tropical, tweed.
Example: stripes
price_minnumberLowest price, whole USD. Matched on the base price, so a few items can show slightly outside the range.
Example: 20
price_maxnumberHighest price, whole USD (see price_min).
Example: 60
clearancebooleanOnly clearance items.
Example: true
seller_typestring | string[]Who sells, up to 3. All three by default.
Example: ["thredup"]
thredup— Items thredUP prices and ships.direct_listing— Direct Listings: a private seller sets the price and ships.dropship— Partner listings shipped by a retail partner.
Notes
Store. thredUP has one store: thredup.com in English and US dollars (it ships to the US and Canada from it). There is no country param; every price is USD. Each call costs 1 credit.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# How much of one brand sits in clearance, read daily: 1 credit per page.
data = client.thredup.deals(collection="clearance", brand="J.Crew")["data"]
print(data["total"], data["total_capped"], "clearance items")
for i in data["items"][:5]:
print(i["price"], i["estimated_retail"], i["percent_off"], i["final_sale"], i["title"])Response