thredUP
thredUP Brand API
One brand's items on thredup.com (thredUP's US store, USD) in a department (women by default): each item with price, the estimated original retail and percent off, condition, size, category, who sells it and status. Category, size, condition, colour, material, pattern, price, clearance and seller-type filters; seven sorts (recommended by default). 119 items per page, up to page 21. An unknown brand answers 0 items. 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/jsonbrandstringrequiredBrand as thredUP writes it (brands[].brand, items[].brand, suggestions[].brand). "<Brand> - all brands" covers a brand's sub-lines.
Example: Madewell
departmentenum<string>default:womenDepartment: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity, accessories. thredUP has no men's department.
Example: handbags
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. The answer's sort says which order was applied.
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 statistics import median
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# How far below the estimated original retail one brand is priced, per condition: 1 credit.
items = client.thredup.brand(brand="Madewell")["data"]["items"]
for condition in ["new_with_tags", "excellent", "very_good", "good", "flawed"]:
off = [i["percent_off"] for i in items if i["condition"] == condition and i["percent_off"] is not None]
print(condition, len(off), median(off) if off else None)Response