thredUP API
thredUP prices as structured JSON: each item's price, the estimated original retail and the percent off, the condition grade and the flaws thredUP noted, measurements and materials, and who priced it (thredUP, a Direct Listing seller or a dropship partner). Search with filters, sold items by brand or category, clearance and price drops, on thredUP's US store.
50 free credits on signup. No card.
{ "data": { "item_number": 241601590, "url": "https://www.thredup.com/product/women-zenim-denim-jacket/241601590", "title": "Zenim Denim Jacket", "brand": "Zenim", "category": "Denim Jacket", "category_tags": [], "department": "women", "size": "Size M", "condition": "excellent", "price": 21.99, "currency": "USD", "estimated_retail": 48, "percent_off": 54, "promo": { "percent": 50, "price": 10.99, "code": "50WELCOME" }, "clearance": false, "final_sale": false, "new_with_tags": false, "seller_type": "thredup", "status": "available", "colors": [ "Blue" ], "materials": [ "82% COTTON", "… 2 more (trimmed for preview)" ], "picture_url": "https://cf-assets-thredup.thredup.com/assets/997218510/retina.jpg", "picture_count": 7, "favorite_count": 9, "description": null, "brand_id": 15685, "departments": [ "women" ], "sale": false, "condition_notes": [ "Practically new: shows no obvious signs of being worn or washed." ], "condition_detail": null, "size_detail": { "chart": "womenTop", "scale": "ALPHA", "value": "M" }, "sizing_id": 795, "measurements": { "display": "Item measurements are not available.", "method": "physical", "chest": null, "waist": null, "length": null, "inseam": null, "rise": null, "height": null, "depth": null, "heel_height": null }, "characteristics": { "fit": [], "pattern": [], "material": [], "sleeve_length": [], "neckline": [], "features": [], "stretch": [], "care": [], "inseam_in": null, "rise_in": null, "length_in": null, "chest_in": null, "waist_in": null }, "style_tags": [], "pictures": [ "https://cf-assets-thredup.thredup.com/assets/997218510/retina.jpg", "… 6 more (trimmed for preview)" ], "authentication": null, "certified_authenticity": null, "direct_listing": null, "similar_brands": [] }, "response_time": 2504, "credits": 1}Live calls for item, Rescue boxes, categories, brands, suggestions and trending. Item lists take 15 to 45 seconds, so their tabs show real captures. 3 free runs across every tab, then it's your own key.
What is the Scavio thredUP API?
The Scavio thredUP API is a REST API that returns thredUP items as JSON: price, estimated original retail and percent off, condition, measurements and who priced each item, from search, brand and category lists, sold items, deal collections and one-item detail on thredup.com. One search reaches about 2,500 items. Every call costs 1 credit.
- 12
- endpoints, all live in production
- 119
- items per page, up to page 21 (about 2,500 per query and filter combination)
- 1
- credit per call on every endpoint
The thredUP price data resellers and researchers need
What items are priced at against the estimated original retail, who priced them, their condition, and what sold.
Price against the estimated original retail
POST /api/v1/thredup/searchEvery item carries its price, the estimated original retail and the percent off computed from the two. Page 1 for denim jacket read 119 items at 16.99 to 2,299.99 USD, median 62.99.
Who priced it
POST /api/v1/thredup/searchseller_type splits thredUP-priced items from Direct Listings (a private seller sets the price) and dropship partner listings. On that page: 13 thredUP, 59 Direct Listing, 47 dropship.
Condition, flaws and measurements
POST /api/v1/thredup/productOne item in full: the condition grade and the notes thredUP wrote about wear, measurements, materials, fit, sleeve length, stretch and care, pictures and authentication.
Sold items by brand or category
POST /api/v1/thredup/soldSold listings filtered by brand, category, size, condition, colour or price, each with the price it last listed at. thredUP shows no sale date, so none is returned.
Clearance, Under $10 and price drops
POST /api/v1/thredup/dealsthredUP's deal collections per department, with the same price fields and filters: clearance, the Under $10 range, new arrivals and recently discounted items.
Rescue boxes
POST /api/v1/thredup/rescue-boxesthredUP's mystery bundles: which boxes can be bought now and what each bundle costs per item count.
Brands and similar items
POST /api/v1/thredup/brandOne brand's items per department, and the first 120 items thredUP shows as similar to one item, for comps.
Ids for every filter
POST /api/v1/thredup/categoriesCategory tags, sizing ids, conditions, colours, materials, patterns and price ranges per department, the brand directory, suggestions and trending searches.
All 12 thredUP API endpoints
Every route is a POST, returns JSON, takes the same API key and costs 1 credit. A 400 and failed upstream calls are not charged; a not-found is.
| Endpoint | Returns | Credits |
|---|---|---|
Search/api/v1/thredup/search | Items for a keyword with price, the estimated original retail and percent off, condition, size, brand and who priced each item (thredUP, a Direct Listing seller or a dropship partner); department, brand, category, size, condition, colour, material, pattern, price, clearance and seller-type filters, seven sorts; 119 a page, up to page 21 | 1 |
Product/api/v1/thredup/product | One item in full by item number or link: price, estimated original retail, percent off, condition with the flaws thredUP noted, measurements, materials, fit and care, pictures, authentication, and shipping and buyer protection on Direct Listings | 1 |
Sold/api/v1/thredup/sold | Sold items by brand and / or category (filters only, no keyword) with the price each last listed at, the estimated original retail and condition; thredUP shows no sale date | 1 |
Deals/api/v1/thredup/deals | Clearance, Under $10, new arrivals and recent price drops, per department, with the usual filters | 1 |
Brand/api/v1/thredup/brand | One brand's items in a department, filtered and sorted like search | 1 |
Category/api/v1/thredup/category | One department's category (women's dresses, plus outerwear ...), filtered and sorted like search | 1 |
Similar/api/v1/thredup/similar | The first 120 items thredUP shows as similar to one item, with the same price fields | 1 |
Rescue boxes/api/v1/thredup/rescue-boxes | thredUP's mystery bundles: each box, whether it is available, and its bundle prices per item count | 1 |
Categories/api/v1/thredup/categories | A department's categories and filter values: category tags, sizing ids, conditions, colours, materials, patterns and price ranges | 1 |
Brands/api/v1/thredup/brands | The brand directory per department, by term or by letter, with the exact brand value the lists take | 1 |
Suggestions/api/v1/thredup/suggestions | Search suggestions for a partial query, each with the brand, category and department filters it stands for | 1 |
Trending/api/v1/thredup/trending | Up to 20 trending searches for women, girls or boys, ready to pass to search | 1 |
50 free credits on signup cover 50 calls: 21 pages of one search (about 2,500 items) plus 29 items in full. See plans
What one item's price fields say
Two items read on 2026-11-18: a thredUP-priced jacket from product, and a Direct Listing jacket from the similar list of the same item.
| Field | Meaning | Zenim Denim Jacket (thredUP-priced) | White House Black Market Jacket (Direct Listing) |
|---|---|---|---|
| price | The price thredUP shows, USD | 21.99 | 53.99 |
| estimated_retail | The estimated original retail of a comparable new item: thredUP's estimate, or the seller's on a Direct Listing | 48 | 185 |
| percent_off | Computed from price and estimated_retail; null when the estimate is missing or not above the price | 54 | 71 |
| seller_type | Who priced and ships it: thredup, direct_listing or dropship | thredup | direct_listing |
| condition | new_with_tags, excellent, very_good, good or flawed | excellent | very_good |
| condition_notes | The wear or flaws thredUP noted (product only) | Practically new: shows no obvious signs of being worn or washed. | - |
| measurements | Measured dimensions when thredUP has them (product only) | Item measurements are not available. | - |
| materials | Material composition as listed | 82% COTTON, 16% POLYESTER, 2% SPANDEX | 60% Cotton, 38% Rayon, 2% Spandex |
| promo | A promotion code thredUP shows on the item; price stays the list price | 50% off, 10.99, code 50WELCOME | null |
thredUP defines the estimated retail as the estimated original retail price of a comparable item of the same quality, construction and material offered elsewhere in new condition, set by its merchants (10-Q). On Direct Listings (open beta since June 9, 2026) the seller sets the price and the estimate. On page 1 of denim jacket, 11 of the 59 Direct Listings and 7 of the 47 dropship items were priced above their estimated retail, so their percent_off is null; all 13 thredUP-priced items carried one (median 58% off).
What a sold search returns
Page 1 of sold for brand Coach in handbags, read on 2026-11-18: 119 sold items, all thredUP-priced. Two of them:
| Field | Meaning | Coach Leather Hobo | Coach Satchel |
|---|---|---|---|
| status | Every item on sold | sold | sold |
| price | The price the item last listed at | 140.99 | 111.99 |
| estimated_retail | thredUP's estimated original retail | 530 | 375 |
| percent_off | Computed from the two | 73 | 70 |
| condition | Condition grade | flawed | good |
| sale date | thredUP shows none | not returned | not returned |
On that page the 119 sold prices ran 29.99 to 403.99 USD (median 104.99) and percent off ran 24 to 81 (median 70); the conditions were 39 good, 38 flawed, 25 very good and 17 excellent. total read 6,241. Sold takes filters only: thredUP returns no sold items for free text, so send brand and / or category. The default order for sold is recently discounted.
Deal collections and Rescue boxes
What each collection is, and what the clearance and Rescue boxes captures of 2026-11-18 read.
| collection | What it is | In the capture |
|---|---|---|
| clearance | Clearance items, recommended order | Women's page 1: 119 items at 7.99 to 417.99 USD (median 54.99), median 67.5% off the estimated retail, 51 flawed, 23 final sale; total 10,000+ |
| under_10 | thredUP's Under $10 range, matched on a base price (a few items show slightly above 10) | Not in this capture |
| new_arrivals | Newest first | Not in this capture |
| price_drops | Recently discounted first | Not in this capture |
| rescue-boxes | thredUP's mystery bundles, a separate endpoint | 24 boxes, 2 available: DIY T-Shirts (25 items, 28 USD) and Activewear (15 items, 60 USD) |
Every collection takes the usual department, brand, category, size, condition, colour, material, pattern and seller-type filters. Poll a collection daily and store each reading to see how much of a brand moves into clearance or drops in price.
Price against the estimated original retail, by who priced it
A resale tool reads one brand's thredUP items and splits the price and percent off by seller type, then opens one item for its condition notes and the items thredUP shows as similar. The response on the right is a real product capture.
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,
# split by who priced the item: 1 credit per page of 119.
items = client.thredup.search(query="jacket", brand="Madewell")["data"]["items"]
for seller_type in ["thredup", "direct_listing", "dropship"]:
rows = [i for i in items if i["seller_type"] == seller_type]
off = [i["percent_off"] for i in rows if i["percent_off"] is not None]
print(seller_type, len(rows), "items,",
"median price", median(i["price"] for i in rows) if rows else None,
"median % off estimated retail", median(off) if off else None){
"data": {
"item_number": 241601590,
"url": "https://www.thredup.com/product/women-zenim-denim-jacket/241601590",
"title": "Zenim Denim Jacket",
"brand": "Zenim",
"category": "Denim Jacket",
"category_tags": [],
"department": "women",
"size": "Size M",
"condition": "excellent",
"price": 21.99,
"currency": "USD",
"estimated_retail": 48,
"percent_off": 54,
"promo": {
"percent": 50,
"price": 10.99,
"code": "50WELCOME"
},
"clearance": false,
"final_sale": false,
"new_with_tags": false,
"seller_type": "thredup",
"status": "available",
"colors": [
"Blue"
],
"materials": [
"82% COTTON",
"16% POLYESTER",
"2% SPANDEX"
],
"picture_url": "https://cf-assets-thredup.thredup.com/assets/997218510/retina.jpg",
"picture_count": 7,
"favorite_count": 9,
"description": null,
"brand_id": 15685,
"departments": [
"women"
],
"sale": false,
"condition_notes": [
"Practically new: shows no obvious signs of being worn or washed."
],
"condition_detail": null,
"size_detail": {
"chart": "womenTop",
"scale": "ALPHA",
"value": "M"
},
"sizing_id": 795,
"measurements": {
"display": "Item measurements are not available.",
"method": "physical",
"chest": null,
"waist": null,
"length": null,
"inseam": null,
"rise": null,
"height": null,
"depth": null,
"heel_height": null
},
"characteristics": {
"fit": [],
"pattern": [],
"material": [],
"sleeve_length": [],
"neckline": [],
"features": [],
"stretch": [],
"care": [],
"inseam_in": null,
"rise_in": null,
"length_in": null,
"chest_in": null,
"waist_in": null
},
"style_tags": [],
"pictures": [
"https://cf-assets-thredup.thredup.com/assets/997218510/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997218534/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997218599/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997218582/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997218558/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997120593/retina.jpg",
"https://cf-assets-thredup.thredup.com/assets/997120594/retina.jpg"
],
"authentication": null,
"certified_authenticity": null,
"direct_listing": null,
"similar_brands": []
},
"response_time": 921
}
Why not the official thredUP API?
thredUP has no public developer API. Here is where the Scavio thredUP API fits.
thredUP (no public API)
- No public listing, price or sold-item API for thredup.com
- Resale-as-a-Service is a managed program for brands running their own resale shops and clean-out programs
- Partner brands get data on their own shops, not marketplace search or prices
- No self-serve key or developer documentation for catalog access
Scavio thredUP API
- One Scavio key issued at signup, no application
- Price, estimated original retail and percent off on every item
- thredUP-priced, Direct Listing and dropship items told apart
- Condition notes, measurements and materials per item
- Sold items, clearance, Under $10, new arrivals and price drops
- The same JSON envelope and key as Poshmark, Depop, Mercari, Vinted and every other Scavio platform
ThredUp Inc. (Nasdaq: TDUP) reported Q3 2026 revenue of $88.2 million, up 7%, with 1.82 million active buyers and 1.89 million orders (November 4, 2026). It sold its European business, Remix, in 2024 and ships to the US and Canada. Not legal advice.
What developers build with it
Resale price research
Read what a brand, size and condition is priced at on thredUP, against the estimated original retail.
search + brandthredUP-priced vs Direct Listing
Split prices and percent off by seller_type: thredUP's own pricing next to what private sellers ask.
search + categorySold comps
Read the price sold items last listed at, per brand, category and condition, before pricing a listing.
sold + categoriesBlack Friday monitoring
Poll clearance, price drops and the same searches daily through Black Friday and Cyber Monday and store each reading.
deals + searchItem condition checks
Open an item for its condition notes, measurements, materials and pictures before buying or reselling.
productCross-market resale research
Run the same brand on thredUP, Poshmark, Depop, Mercari and Vinted the same day.
search + brandTrend tracking
Store trending searches and suggestions per department to see what shoppers look for through the season.
trending + suggestionsAI agents
Give an agent thredUP as tools: search, open an item, read sold items and deals, with one key.
MCP + RESTHow to get thredUP prices
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 free credits on signup, with no card.
- 2
Search thredUP
Send {"query": "denim jacket"} to https://api.scavio.dev/api/v1/thredup/search with an Authorization: Bearer header. You get 119 items per page, each with price, estimated_retail, percent_off, condition and seller_type.
- 3
Use the brand filter and the ids
Free text is matched loosely, so pass brand for one brand. Read categories for category tags and sizing ids, brands or suggestions for exact brand names. One query and filter combination reaches 21 pages, about 2,500 items.
- 4
Open items and store each reading
Send an item_number to product for condition notes and measurements, and read sold and deals the same way. Store price, estimated_retail and fetched_at: thredUP shows no price history, so your readings are the series.
thredUP API FAQ
Does thredUP have a public API?
+
No. thredUP publishes no public developer API for listings, prices or sold items. Its Resale-as-a-Service program is a managed program for brands that run their own resale shops and clean-out programs; it gives partner brands data on their own shops, not marketplace search or prices. The Scavio thredUP API is a separate option: 12 POST endpoints on one key. Other vendors also sell thredUP data.
What is estimated retail on thredUP?
+
estimated_retail is the estimated original retail price of a comparable item sold new. thredUP's 10-Q says its merchants set it by monitoring market prices for the brands and styles it offers; on Direct Listings the seller enters it. It is an estimate, not a checked retail price, so label figures as "of the estimated original retail". percent_off is computed by Scavio from the price and the estimated retail; thredUP's own savings figure starts from a base price and can differ by a point or more. thredUP Product API docs
What is the difference between Direct Listing and thredUP-priced items?
+
seller_type thredup means thredUP prices and ships the item. direct_listing means a Direct Listing: thredUP launched Direct Listing, its peer-to-peer selling, in open beta on June 9, 2026, and the private seller sets the price and ships the item. dropship means a partner listing shipped by a retail partner; these can carry a style name in category and a price above the estimated retail. All three are returned by default; pass seller_type to narrow. No seller names are returned.
Can I get thredUP sold prices and sold dates?
+
Sold items, yes; sold dates, no. sold returns sold items by brand and / or category with the price each item last listed at, its estimated original retail and condition. thredUP shows no sale date, so none is returned, and it returns no sold items for free text, so sold takes filters, not a keyword. thredUP Sold Listings API docs
How many items can one search return?
+
119 per page, pages 1 to 21: about 2,500 items per query and filter combination. total is thredUP's approximate count and reads 10,000 at most (total_capped true means 10,000 or more). To read further, narrow with filters or split by price ranges. A page above 21 answers 400, not charged. thredUP Search API docs
Why does a brand search return other brands?
+
thredUP's free-text search is semantic: it matches the look, so typing a brand name as query also returns similar brands. Use the brand filter (or the brand endpoint) with the exact name from brands or suggestions to read one brand.
Does thredUP sell men's clothing?
+
thredUP has no men's department. The departments are women, girls, boys, handbags, shoes, designer, plus, juniors, maternity and accessories; department men answers 400, not charged.
Does it cover thredUP Canada?
+
thredUP has one store, thredup.com, in English and US dollars, and its help center says it ships to the United States and Canada from it. So there is no country param and every price is in USD. thredUP sold its European business, Remix, in 2024.
Does it return thredUP reviews?
+
No. thredUP shows no product reviews on its items, so there are none to return. Seller shops and seller names are not returned either.
Does it return thredUP price history?
+
No. thredUP shows the current price, not a history, and Scavio does not cache responses. Poll the searches, deals or items you care about on a schedule and store price, estimated_retail and fetched_at: your readings are the history.
Can I track thredUP prices through Black Friday?
+
Yes, by polling. Read the clearance and price_drops collections and the same brand searches daily through Black Friday (November 27, 2026) and Cyber Monday (November 30), and store each reading. promo shows a code thredUP offers on an item while price stays the list price, so note both with the date.
Are the price filters exact?
+
Close, not exact. price_min and price_max are whole US dollars, and thredUP matches them on an item's base price, so a few items can show slightly outside the range (a 0 to 10 range returned items at 11.99 to 12.99). Filter again on price in your own code when the bound matters.
Which filters and conditions can I use?
+
department, brand, category (tags from categories), size (sizing ids from categories, up to 10), condition (new_with_tags, excellent, very_good, good, flawed; up to 5), colour and material (up to 5 each), pattern, price_min / price_max, clearance and seller_type, with seven sorts: default, recommended, relevance, newest, price_low, price_high and price_drop.
What do thredUP's terms say?
+
Scavio does not collect or store thredUP data: each call fetches the public thredUP page at the moment your request asks for it and returns what it shows as JSON, with no response cache. Read thredUP's current terms for your use case; this is not legal advice.
How much does a thredUP request cost?
+
1 credit per call on every endpoint. New accounts get 50 free credits on signup, one time and with no card. Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth credits cost $1 per 1,000. A 400 and a failed upstream call are not charged; a not-found (an unknown item number) is charged.
How fresh is the data, and how long does a call take?
+
Every request reads thredUP when you call it and carries fetched_at; nothing is cached. Item lists (search, sold, category, brand, deals, similar) usually take 15 to 45 seconds, product, categories, brands and trending 1 to 3, suggestions and Rescue boxes a few seconds. Set a client timeout of 180 seconds.
Explore more of Scavio
Best thredUP secondhand price APIs
Seven options priced, plus 25 brands read the same day: the median thredUP-priced item was 60% off thredUP's own estimated retail, 0.7% at 90% off.
How to get thredUP prices
Search with a brand filter, thredUP-priced vs Direct Listing splits, one item's flaws and measurements, sold items, deals and a daily Black Friday poll.
Is thredUP overpriced?
Median 60% off thredUP's estimated retail, but 7.6% of items from the brands shoppers name were under $20; Banana Republic tops median $34.99.
Poshmark API
Poshmark sold listings with sold dates, listings with the original price the seller entered, closets and Love Notes.
Depop API
Depop listings priced per buyer market, a shop's sold listings and seller reviews.
Mercari API
Sold and on-sale listings, sold time and price drops, US and Japan.
Vinted API
Second-hand listings, the Vinted fee, sold state and seller ratings on 27 sites.
eBay API
Live eBay prices, listings and sellers.
thredUP API docs
All 12 endpoints with params, credits and real responses.
Start reading thredUP prices
50 free credits on signup, no card. One key for thredUP and every other Scavio platform.