thredUP
thredUP Sold Listings API
Sold items on thredup.com (thredUP's US store, USD), by filters only: brand and / or category, with department, size, condition, colour, material, pattern, price, clearance and seller-type filters (thredUP orders sold pages itself, recently discounted first). Each item carries status sold and the price it last listed at, next to the estimated original retail, percent off, condition and the other item fields. thredUP returns no sold items for free text and shows no sale date, so there is no query and no sold date. 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
Send brand, category or both.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
departmentenum<string>default:womenDepartment: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity, accessories. thredUP has no men's department.
Example: handbags
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)
# The price sold Coach handbags last listed at, per condition: 1 credit per page.
items = client.thredup.sold(brand="Coach", department="handbags")["data"]["items"]
for condition in ["excellent", "very_good", "good", "flawed"]:
prices = [i["price"] for i in items if i["condition"] == condition]
print(condition, len(prices), "sold, median last listed price", median(prices) if prices else None)Response