ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

thredUP

thredUP Brand API

One brand's items on thredup.com (thredUP's US store, USD) in a department (women by default): each item with price, the estimated original retail and percent off, condition, size, category, who sells it and status. Category, size, condition, colour, material, pattern, price, clearance and seller-type filters; seven sorts (recommended by default). 119 items per page, up to page 21. An unknown brand answers 0 items. Costs 1 credit.

POST/api/v1/thredup/brand

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
brandstringrequired

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

Example: Madewell

departmentenum<string>default:women

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

Example: handbags

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)

# How far below the estimated original retail one brand is priced, per condition: 1 credit.
items = client.thredup.brand(brand="Madewell")["data"]["items"]
for condition in ["new_with_tags", "excellent", "very_good", "good", "flawed"]:
    off = [i["percent_off"] for i in items if i["condition"] == condition and i["percent_off"] is not None]
    print(condition, len(off), median(off) if off else None)

Response

"brand": "Madewell",
"department": "women",
"sort": "recommended",
"page": 1,
"page_size": 119,
"total": 10000,
"total_capped": true,
"has_more": true,
"count": 119,
"currency": "USD",
},
"response_time": 17167
}
PreviousthredUP CategoryNextthredUP Deals
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