ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/thredup/search

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
querystringrequired

Search text, 1-200 characters. Matched loosely: use brand for one brand.

Example: denim jacket

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. 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)

# 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

"query": "denim jacket",
"sort": "relevance",
"page": 1,
"page_size": 119,
"total": 10000,
"total_capped": true,
"has_more": true,
"count": 119,
"currency": "USD",
},
"response_time": 18697
}
PreviousPoshmark Similar ListingsNextthredUP Sold Listings
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