thredUP
thredUP Category API
One department's category on thredup.com (thredUP's US store, USD), such as women's dresses: each item with price, the estimated original retail and percent off, condition, size, brand, who sells it and status. Brand, size, condition, colour, material, pattern, price, clearance and seller-type filters; seven sorts (recommended by default). 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/jsondepartmentenum<string>requiredDepartment: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity, accessories.
Example: women
categorystringrequiredA category tag from categories (categories[].category: dresses, tops, outerwear, jeans, one-pieces ...).
Example: dresses
brandstringOne brand as thredUP writes it (items[].brand, brands[].brand, suggestions[].brand). "<Brand> - all brands" covers a brand's sub-lines.
Example: Madewell
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 scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# Women's dresses with original tags attached, cheapest first: 1 credit.
data = client.thredup.category(department="women", category="dresses", condition="new_with_tags", sort="price_low")["data"]
for i in data["items"][:10]:
print(i["price"], i["estimated_retail"], i["percent_off"], i["brand"], i["size"])Response