thredUP
thredUP Search API
Search thredup.com (thredUP's US store, USD): each item with its item number, title, brand, category, size, condition, price, the estimated original retail and percent off, promo, clearance and final-sale flags, who sells it (thredUP, a Direct Listing seller or a dropship partner), status, colours, materials and favourites. Free text is matched loosely (use the brand filter for one brand). Department, brand, category, size, condition, colour, material, pattern, price, clearance and seller-type filters; seven sorts. 119 items per page, up to page 21 (about 2,500 items per query). 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/jsonquerystringrequiredSearch text, 1-200 characters. Matched loosely: use brand for one brand.
Example: denim jacket
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. 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)
# Price against the estimated original retail, split by who priced the item: 1 credit per page.
data = client.thredup.search(query="denim jacket", condition=["excellent", "very_good"])["data"]
for seller_type in ["thredup", "direct_listing", "dropship"]:
off = [i["percent_off"] for i in data["items"] if i["seller_type"] == seller_type and i["percent_off"] is not None]
print(seller_type, len(off), "items, median % off estimated retail:", median(off) if off else None)Response