ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Blog
Thredup12 min readNov 18, 2026

How to Get thredUP Prices With an API: Price, Estimated Retail, % Off, Condition and Measurements From thredup.com

Get thredUP prices with Scavio's thredUP API: price, estimated retail, % off, condition, measurements, sold items and deals as JSON, with curl and a daily poll.

Scavio Team

Nov 18, 2026

Try the thredUP API free
scavio
Resale / Fashion
Thredup

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

Bash
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:

JSON
{
  "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: price is the list price. estimated_retail is the estimated original retail of a comparable new item: thredUP's estimate on thredUP-priced items, the seller's on Direct Listings. percent_off is computed from those two.
  • Promo codes: promo is a code thredUP offers on the item, here a first-order code. price stays the list price.
  • Who priced it: seller_type says 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 as brand.
  • Brand names: brand takes the name as thredUP writes it (step 7). "Banana Republic - all brands" covers a brand's sub-lines.
  • Counts: total is thredUP's count; it reads 10,000 with total_capped true when there are more.

Step 2: Read one brand, and split by who priced it

Bash
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"]}'
JSON
{
  "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 and seller_type.
  • Sorts: default, recommended, relevance, newest, price_low, price_high and price_drop. The answer's sort says 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

Python
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

Bash
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}'
JSON
{
  "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_notes and condition_detail, the flaws thredUP noted;
  • measurements, the size chart, fit, neckline and care in characteristics;
  • 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:

JSON
{
  "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

Bash
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"}'
JSON
{
  "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 brand and / or category; 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 sort you send. We sent "sort": "recommended" for 10 brands; every answer reported price_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

Bash
curl -s https://api.scavio.dev/api/v1/thredup/deals \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection": "clearance"}'
JSON
{
  "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

Bash
curl -s https://api.scavio.dev/api/v1/thredup/categories \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"department": "women"}'
JSON
{
  "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. category takes the tag, and size takes 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 the brand value 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:

Python
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 promo code is a separate discount; price stays the list price.

All thredUP endpoints

EndpointWhat it returnsCredits
searchItems for a query with filters, 119 a page, up to page 211
brandOne brand's items in a department, with filters1
categoryOne department's category, with filters1
soldSold items by brand and / or category, the price each last listed at1
dealsClearance, Under $10, new arrivals, price drops1
productOne item in full: flaws, measurements, characteristics, pictures1
similarThe first 120 items thredUP shows as similar1
rescue-boxesRescue boxes and their bundle prices1
categoriesCategories, sizing ids, conditions, colours, materials, patterns, price ranges1
brandsThe brand directory by query or letter1
suggestionsSearch suggestions as ready filter sets1
trendingTrending searches1

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

  1. Create a free account: 50 credits, no card, enough for 50 brand pages.
  2. Copy your API key and set it as SCAVIO_API_KEY.
  3. Run step 2 with your own brand, or try it first in the playground.
  4. 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.

thredUP prices as JSON

  • Search and brand pages with brand, size, condition, price and seller-type filters
  • Price, estimated original retail, percent off, flaws and measurements on every item
  • Sold items, clearance and price drops, 1 credit a call
Try the thredUP API free

50 free credits, no credit card

On this page

  1. Step 1: Search thredUP, and use the brand filter for a brand
  2. Step 2: Read one brand, and split by who priced it
  3. Step 3: Compute the percent off, and flag what does not add up
  4. Step 4: Open one item for its flaws and measurements

Related articles

View all
  • scavio
    Resale / Fashion
    Thredup
    7 Best thredUP Secondhand Price APIs in 2026: Scavio Read 25 Brands Against thredUP's Own Estimated Retail, and the Median Item Was 60% Off
  • scavio
    Fashion / Sale prices
    Fashion nova
    How to Get Fashion Nova Sale Prices With an API: Price, Comp. Value, Sizes in Stock and Reviews in 104 Countries
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