ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/thredup/sold

Authorizations

Authorizationstringheaderrequired

Bearer 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.
brandstring

One brand as thredUP writes it (items[].brand, brands[].brand, suggestions[].brand). "<Brand> - all brands" covers a brand's sub-lines.

Example: Madewell

categorystring

A category tag from categories (categories[].category: dresses, tops, outerwear, jeans, one-pieces ...).

Example: outerwear

departmentenum<string>default:women

Department: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity, accessories. thredUP has no men's department.

Example: handbags

pageintegerdefault:1

Page, 1 to 21, 119 items each (about 2,500 items per query and filter combination).

Example: 2

sortenum<string>default:default

Result 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"]

patternstring

One 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_minnumber

Lowest price, whole USD. Matched on the base price, so a few items can show slightly outside the range.

Example: 20

price_maxnumber

Highest price, whole USD (see price_min).

Example: 60

clearanceboolean

Only 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

"status": "sold",
"sort": "price_drop",
"page": 1,
"page_size": 119,
"total": 6241,
"total_capped": false,
"has_more": true,
"count": 119,
"currency": "USD",
},
"response_time": 39538
}
PreviousthredUP SearchNextthredUP Product
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy