ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

thredUP

thredUP Deals API

thredUP's deal collections on thredup.com (thredUP's US store, USD): clearance, under_10 (thredUP's Under $10 range), new_arrivals (newest first) and price_drops (recently discounted first), in a department (women by default) with the usual brand, category, size, condition, colour, material, pattern, price and seller-type filters. Each item with price, the estimated original retail and percent off, clearance and final-sale flags. 119 items per page, up to page 21. Costs 1 credit.

POST/api/v1/thredup/deals

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

application/json
collectionenum<string>required

Which deal collection.

Example: clearance

  • clearance — Clearance items.
  • under_10 — thredUP's Under $10 range, matched on the base price (sets the price range itself).
  • new_arrivals — Newest first (a sort of its own).
  • price_drops — Recently discounted first (a sort of its own).
departmentenum<string>default:women

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

Example: handbags

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

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, for clearance and under_10 only (new_arrivals and price_drops are sorts themselves).

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 scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=180)

# How much of one brand sits in clearance, read daily: 1 credit per page.
data = client.thredup.deals(collection="clearance", brand="J.Crew")["data"]
print(data["total"], data["total_capped"], "clearance items")
for i in data["items"][:5]:
    print(i["price"], i["estimated_retail"], i["percent_off"], i["final_sale"], i["title"])

Response

"collection": "clearance",
"department": "women",
"sort": "recommended",
"page": 1,
"page_size": 119,
"total": 10000,
"total_capped": true,
"has_more": true,
"count": 119,
"currency": "USD",
},
"response_time": 17090
}
PreviousthredUP BrandNextthredUP Rescue Boxes
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