To get thredUP prices, call Scavio's thredUP API: POST /api/v1/thredup/brand with a brand, or search with a query and a brand filter, returns 119 items a page from thredUP's US store, each with the price, the estimated original retail, the percent off, the condition, the size, the materials and who priced it (seller_type), for 1 credit. product opens one item with the flaws thredUP noted and its measurements, sold reads sold items by brand or category, and deals reads clearance, Under $10, new arrivals and price drops.
thredUP sells secondhand women's and kids' clothing, shoes and bags on one US store, thredup.com, in US dollars, and ships to the US and Canada. Most items are priced by thredUP, which also sets an estimated original retail for each one. Since June 9, 2026, Direct Listings from private sellers sit on the same pages, and there the seller sets the price and enters the estimated retail. thredUP has no public developer API.
Every response below is a trimmed capture from Scavio's thredUP API on November 18, 2026, between 17:55 and 18:34 UTC. Picture links are cut from every sample. Prices are numbers in US dollars. List endpoints are slow: a median 16 seconds a call in our runs, so give your HTTP client a long timeout.
Step 1: Search thredUP, and use the brand filter for a brand
curl -s https://api.scavio.dev/api/v1/thredup/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "top", "brand": "Banana Republic"}'The first of the 119 items on page 1:
{
"query": "top",
"sort": "relevance",
"filters": { "department": "women", "brand": "Banana Republic", "seller_type": ["thredup", "direct_listing", "dropship"] },
"page": 1,
"page_size": 119,
"total": 194,
"total_capped": false,
"has_more": true,
"count": 119,
"currency": "USD",
"items": [
{
"item_number": 241427948,
"title": "Banana Republic 3/4 Sleeve Blouse",
"brand": "Banana Republic",
"category": "3/4 Sleeve Blouse",
"category_tags": ["tops"],
"size": "Size M",
"condition": "excellent",
"price": 26.99,
"currency": "USD",
"estimated_retail": 100,
"percent_off": 73,
"promo": { "percent": 50, "price": 13.49, "code": "50WELCOME" },
"clearance": false,
"final_sale": false,
"new_with_tags": false,
"seller_type": "thredup",
"status": "available",
"colors": ["White"],
"materials": ["100% RAMIE"],
"picture_count": 6,
"favorite_count": 9
}
]
}- Prices:
priceis the list price.estimated_retailis the estimated original retail of a comparable new item: thredUP's estimate on thredUP-priced items, the seller's on Direct Listings.percent_offis computed from those two. - Promo codes:
promois a code thredUP offers on the item, here a first-order code.pricestays the list price. - Who priced it:
seller_typesays thredup, direct_listing or dropship. - Search text is matched loosely. The same search with only
"query": "banana republic"returned 82 different brands on page 1 and 4 Banana Republic items, so send the brand asbrand. - Brand names:
brandtakes the name as thredUP writes it (step 7). "Banana Republic - all brands" covers a brand's sub-lines. - Counts:
totalis thredUP's count; it reads 10,000 withtotal_cappedtrue when there are more.
Step 2: Read one brand, and split by who priced it
curl -s https://api.scavio.dev/api/v1/thredup/brand \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brand": "Banana Republic", "department": "women", "seller_type": ["direct_listing"]}'{
"brand": "Banana Republic",
"department": "women",
"sort": "recommended",
"filters": { "department": "women", "brand": "Banana Republic", "seller_type": ["direct_listing"] },
"page_size": 119,
"total": 1857,
"total_capped": false,
"count": 119,
"items": [
{
"item_number": 1501687553,
"title": "Banana Republic Coat",
"category_tags": ["outerwear"],
"size": "Size XS",
"condition": "excellent",
"price": 125.99,
"estimated_retail": 280,
"percent_off": 55,
"promo": null,
"final_sale": true,
"seller_type": "direct_listing",
"status": "available",
"materials": ["52% Polyester", "40% Wool", "8% Other"],
"favorite_count": 165
}
]
}Brand and category return the same item shape as search, without a query.
- Filters: department, category, size, condition, colour, material, pattern,
price_min/price_max, clearance andseller_type. - Sorts: default, recommended, relevance, newest, price_low, price_high and price_drop. The answer's
sortsays which one thredUP applied.
Always split by seller_type if you compare prices. thredUP's default order puts its own items first. When we read 25 brands, the all-sellers page 1 held one Direct Listing or none in 23 of them. Yet Direct Listings were 1,857 of Banana Republic's women's items, 63% of Ralph Lauren's and 57% of Coach handbags. One call per seller type gives you each side in full.
Step 3: Compute the percent off, and flag what does not add up
import json, statistics
page = json.load(open("brand.json"))["data"]["items"]
priced = [i for i in page if i["percent_off"] is not None]
print("median % off:", statistics.median(i["percent_off"] for i in priced), "of", len(page))
print("at 90%+ off:", sum(i["percent_off"] >= 90 for i in priced))
print("price at or above estimated retail:", [i["item_number"] for i in page if i["percent_off"] is None])
print("under $20:", sum(i["price"] < 20 for i in page))percent_off is round((1 - price / estimated_retail) x 100). It is null when the estimated retail is missing or not above the price. thredUP's own savings figure can use a different base, so compare against this field rather than the badge on the site. Two things we saw on November 18:
- Direct Listings can show a price above the seller's estimated retail. That was true of 385 of the 2,597 Direct Listings we read (14.8%). thredUP says its Direct Listing buyer fee "will be included in the buyers price". Among thredUP-priced items it was 5 of 2,869.
- Direct Listing retail is whatever the seller types. A few items carried an estimated retail of 9,999 or 9,925 on a $22.99 or $26.99 item. Treat Direct Listing percent-off figures as the seller's, and test thredUP's "up to 90% off" on thredUP-priced items only. 19 of 2,863 reached it in our read.
Step 4: Open one item for its flaws and measurements
curl -s https://api.scavio.dev/api/v1/thredup/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_number": 239280773}'{
"item_number": 239280773,
"title": "Banana Republic Cashmere Pullover Sweater",
"brand": "Banana Republic",
"size": "Size XXS",
"condition": "very_good",
"price": 42.99,
"currency": "USD",
"estimated_retail": 200,
"percent_off": 79,
"promo": { "percent": 50, "price": 21.49, "code": "50WELCOME" },
"seller_type": "thredup",
"status": "available",
"materials": ["100% CASHMERE"],
"brand_id": 982,
"condition_notes": ["No major flaws. Inspection shows: minor wear on fabric."],
"condition_detail": "minor wear on fabric",
"size_detail": { "chart": "womenTop", "scale": "ALPHA", "value": "XXS" },
"sizing_id": 755,
"measurements": {
"display": "Measured at 19.5\" length (approx.)",
"method": "automated",
"chest": null,
"waist": null,
"length": 19.5
},
"characteristics": { "sleeve_length": ["long sleeve"], "neckline": ["turtleneck"] },
"direct_listing": null,
"similar_brands": [
{ "id": 1249, "name": "Ann Taylor", "department": "women" },
{ "id": 1354, "name": "Kate Hill", "department": "women" }
]
}Product takes item_number or a thredup.com item link and adds:
condition_notesandcondition_detail, the flaws thredUP noted;measurements, the size chart, fit, neckline and care incharacteristics;- every picture, authentication, and similar brands.
Measurements are often missing: three of the four items we opened said "Item measurements are not available."
On a Direct Listing, description is the seller's text and direct_listing carries the shipping and buyer protection:
{
"item_number": 1502271338,
"title": "Banana Republic Long Sleeve Top",
"price": 36.99,
"estimated_retail": 30,
"percent_off": null,
"seller_type": "direct_listing",
"description": "Long-sleeve pink top with a rounded hem.",
"direct_listing": { "shipping_cost": 8.99, "shipping_covered": true, "buyer_protection_price": 4.56, "on_vacation": false }
}No seller or consignor names or ids are returned. Sold items still open, with status sold and the price they last listed at. 1 credit; an unknown item is a charged 404.
Step 5: Read sold items by brand or category
curl -s https://api.scavio.dev/api/v1/thredup/sold \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brand": "Banana Republic", "department": "women"}'{
"status": "sold",
"sort": "price_drop",
"total": 10000,
"total_capped": true,
"count": 119,
"items": [
{
"item_number": 233356837,
"title": "Banana Republic Cardigan",
"size": "Size L",
"condition": "flawed",
"price": 13.99,
"estimated_retail": 150,
"percent_off": 91,
"promo": null,
"clearance": true,
"seller_type": "thredup",
"status": "sold"
}
]
}Sold returns items thredUP has sold, with the price each one last listed at.
- Input: filters only. Send
brandand / orcategory; thredUP returns no sold items for free text. - No dates: thredUP shows no sale date, so none comes back.
- Fixed order: sold pages come most recently discounted first, and thredUP keeps that order whatever
sortyou send. We sent"sort": "recommended"for 10 brands; every answer reportedprice_drop, with 116 to 119 of the same 119 items.
So read a sold page as "the sold items thredUP shows first", not as the latest sales or a typical sale. On those 10 brands, 402 of the 1,190 sold items (34%) were clearance.
Step 6: Read the deal collections
curl -s https://api.scavio.dev/api/v1/thredup/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"collection": "clearance"}'{
"collection": "clearance",
"department": "women",
"sort": "recommended",
"filters": { "department": "women", "clearance": true, "seller_type": ["thredup", "direct_listing", "dropship"] },
"total": 10000,
"total_capped": true,
"count": 119,
"items": [
{
"item_number": 233263088,
"title": "One Step Up Short Sleeve Turtleneck",
"price": 7.99,
"estimated_retail": 13,
"percent_off": 39,
"clearance": true,
"final_sale": true,
"seller_type": "thredup"
}
]
}Deals takes collection: clearance, under_10, new_arrivals or price_drops, in a department with the usual filters. What page 1 of each women's collection held on November 18:
- Clearance: median $54.99 and 67.5% off; 117 of 119 thredUP-priced.
- Under $10: 59 of 119 listed at $10.99 to $13.99, because thredUP matches the price filter on a base price.
- New arrivals: 57 of 119 were Direct Listings.
- Price drops: all 119 were dropship partner listings, 63 of them Birkenstock.
Rescue boxes lists thredUP's mystery bundles with their prices per item count. 1 credit each.
Step 7: Get the ids for filters
curl -s https://api.scavio.dev/api/v1/thredup/categories \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"department": "women"}'{
"department": "women",
"categories": [{ "name": "Dresses", "category": "dresses" }, { "name": "Tops", "category": "tops" }],
"other_departments": [{ "name": "Shoes", "department": "shoes" }],
"sizes": [{ "group": null, "label": "XXS", "long_label": null, "size": 755 }, { "group": null, "label": "XS", "long_label": null, "size": 765 }],
"conditions": [{ "label": "Original Tags Attached", "condition": "new_with_tags" }, { "label": "Flawed gems", "condition": "flawed" }],
"price_ranges": [{ "label": "Under $10", "price_min": 0, "price_max": 10 }, { "label": "$10 - $25", "price_min": 10, "price_max": 25 }],
"category_count": 13,
"size_count": 65
}- Categories: the inputs the list endpoints take.
categorytakes the tag, andsizetakes the sizing id, not the label. - Condition values: new_with_tags, excellent, very_good, good and flawed.
- Brands: the brand directory.
{"query": "ann taylor"}returned 8 brands, among them "Ann Taylor", "Ann Taylor Factory" and "Ann Taylor LOFT", each with thebrandvalue to send. - Suggestions and trending: turn a partial query into a ready filter set, and list thredUP's trending searches.
- Departments: women, girls, boys, handbags, shoes, designer, plus, juniors, maternity and accessories. thredUP has no men's department.
Step 8: Poll prices daily through Black Friday
Black Friday is November 27, 2026. thredUP shows the current price and no history, and Scavio keeps no cache, so any price history is the one you store. This script reads page 1 of each brand once a day, once for thredUP-priced items and once for Direct Listings. It appends what it reads to a file, deduplicated by item_number, and adds up credits_used:
import datetime, json, os, urllib.request
KEY = os.environ["SCAVIO_API_KEY"]
BRANDS = ["Banana Republic", "J.Crew", "Madewell", "Athleta", "Free People"]
def call(body):
req = urllib.request.Request(
"https://api.scavio.dev/api/v1/thredup/brand",
data=json.dumps(body).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
)
with urllib.request.urlopen(req, timeout=180) as r:
return json.load(r)
today = datetime.date.today().isoformat()
seen, credits = set(), 0
with open(f"thredup-{today}.jsonl", "a") as out:
for brand in BRANDS:
for seller in ("thredup", "direct_listing"):
res = call({"brand": brand, "department": "women", "seller_type": [seller]})
credits += res["credits_used"]
for item in res["data"]["items"]:
if item["item_number"] in seen:
continue
seen.add(item["item_number"])
out.write(json.dumps({
"captured": today, "brand": brand, "item_number": item["item_number"],
"seller_type": item["seller_type"], "condition": item["condition"],
"price": item["price"], "estimated_retail": item["estimated_retail"],
"percent_off": item["percent_off"], "clearance": item["clearance"],
"status": item["status"],
}) + "\n")
print("credits used:", credits)What it costs:
- Per brand: 2 credits a day.
- These five brands: 10 credits a day, and 50 credits from November 26 to November 30, which is $0.05 at the Growth rate of $1 per 1,000 credits.
- The 25 brands in the best thredUP secondhand price APIs: 50 credits a day, 250 for the five days.
Two things to keep in mind when you read the series:
- Compare the same item across days, joined on
item_number, not one day's median against another's. The page's make-up changes as items sell. - A price drop on an item you watch is the signal. A
promocode is a separate discount;pricestays the list price.
All thredUP endpoints
| Endpoint | What it returns | Credits |
|---|---|---|
search | Items for a query with filters, 119 a page, up to page 21 | 1 |
brand | One brand's items in a department, with filters | 1 |
category | One department's category, with filters | 1 |
sold | Sold items by brand and / or category, the price each last listed at | 1 |
deals | Clearance, Under $10, new arrivals, price drops | 1 |
product | One item in full: flaws, measurements, characteristics, pictures | 1 |
similar | The first 120 items thredUP shows as similar | 1 |
rescue-boxes | Rescue boxes and their bundle prices | 1 |
categories | Categories, sizing ids, conditions, colours, materials, patterns, price ranges | 1 |
brands | The brand directory by query or letter | 1 |
suggestions | Search suggestions as ready filter sets | 1 |
trending | Trending searches | 1 |
Every endpoint costs 1 credit and reads thredUP's US store, so there is no country input. A failed upstream call is not charged; a not-found is.
Not available:
- sold dates and price history;
- product reviews, which thredUP does not show;
- seller shops and payout data;
- men's clothing, because thredUP has no men's department;
- more than about 2,500 items per query and filter combination (21 pages of 119).
Getting started
- Create a free account: 50 credits, no card, enough for 50 brand pages.
- Copy your API key and set it as
SCAVIO_API_KEY. - Run step 2 with your own brand, or try it first in the playground.
- Read the brand docs for every parameter, or connect the MCP server to use thredUP from an agent.
Is thredUP overpriced? uses these calls to answer an r/ThredUp thread with data. The Poshmark and Depop guides cover the same job on those marketplaces.
Frequently asked questions
Does thredUP have a public API?
No. thredUP publishes no public developer API for listings or prices; Resale-as-a-Service is a managed resale program thredUP runs for brands, not a data API. Scavio's thredUP API returns thredUP's public search, brand, category, sold, deal and item pages as JSON, 1 credit a call.
Can you see sold prices on thredUP?
Yes, for sold items thredUP still shows: Scavio's sold endpoint returns them by brand and / or category with the price each item last listed at, its estimated original retail and condition. thredUP shows no sale date and lists sold items most recently discounted first, so read a sold page as the sold items thredUP shows first.
Does thredUP sell men's clothing?
No. thredUP's departments are women, girls, boys, handbags, shoes, designer, plus, juniors, maternity and accessories, with no men's department, so there are no men's prices to read.
Does thredUP ship to Canada?
Yes. thredUP's help says it ships to the US and Canada. Both are served from the same US store in US dollars, so there is one set of prices and Scavio's thredUP API has no country input.
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. thredUP's terms of service cover how its service may be used; read thredUP's current terms for your use case and get your own advice. This is not legal advice.