thredUP Item API Documentation Read one thredUP item by item number or product url. The item has everything of a search row plus condition code and condition notes (flaws as listed), measurements in inches, detailed size, product attributes such as wash, cut, pattern, neckline, sleeve length and care, photos with their type, authentication type, where it ships from, similar brands and the reseller for third party items. Sold or removed items answer 404: thredUP does not show sold prices. Each request costs 1 credit. A 404 and a failed request are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
2 optional filters available.
integer
Optional
The number at the end of a thredUP product url, or the item_number of a search row, e.g. 1501078587. Required unless you send a url.
10
string
Optional
A thredup.com product url that ends with the item number. Required unless you send an item number.
https://example.com/product
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
item
meta
success
{
"item": {
"id": 219390118,
"url": "https://www.thredup.com/product/women-gucci-gucci-leather-satchel/1501078587",
"msrp": 326,
"size": {
"chart": null,
"label": "One size",
"scale": null,
"value": "One size",
"eu_label": null,
"size_ids": [
902
],
"detailed_label": "One size"
},
"brand": "Gucci",
"price": 299.99,
"state": "listed",
"title": "Gucci Leather Satchel",
"colors": [
"Tan"
],
"gender": "women",
"images": [
"https://cf-assets-thredup.thredup.com/assets/1517570766/xlarge.jpg",
"https://cf-assets-thredup.thredup.com/assets/1517570767/xlarge.jpg"
],
"photos": [
{
"url": "https://cf-assets-thredup.thredup.com/assets/1517570766/xlarge.jpg",
"type": "regular"
},
{
"url": "https://cf-assets-thredup.thredup.com/assets/1517570767/xlarge.jpg",
"type": "regular"
}
],
"seller": {
"name": "eLADY",
"type": "dropshipper",
"ships_from": null,
"on_vacation": null
},
"brand_id": 138,
"category": "handbags",
"currency": "USD",
"clearance": true,
"condition": {
"code": "Q2",
"label": "Very good",
"notes": [
"No major flaws. Inspection shows: overall scratches: slight, overall dirt: slight, overall traces of use: slight, notice: before purchasing, please refer to the images for the exact condition of the item., damage: bottom: crack - slight, handle: peelings - slight, handle: crack - slight, ."
],
"value": "very-good",
"detail": "Overall Scratches: Slight, Overall Dirt: Slight, Overall Traces of Use: Slight, Notice: Before purchasing, please refer to the images for the exact condition of the item., Damage: Bottom: Crack - Slight, Handle: Peelings - Slight, Handle: Crack - Slight",
"new_with_tags": false
},
"materials": [
"50% Leather",
"50% Canvas"
],
"attributes": {
"depth_in": 7.67,
"material": "canvas",
"height_in": 7.08,
"length_in": 6.88
},
"final_sale": true,
"ships_from": null,
"style_tags": [],
"description": "Tan monogram GG canvas handbag with beige leather trim and gold-tone hardware, featuring rounded handles and detachable zip closure",
"item_number": 1501078587,
"availability": "InStock",
"measurements": {
"text": "Measured at 6.88\" length, 7.08\" height, 7.67\" depth (approx.)",
"unit": "in",
"method": "physical",
"values": {
"depth": 7.67,
"height": 7.08,
"length": 6.88
}
},
"category_tags": [],
"authentication": {
"type": "SELLER",
"certificate_included": false,
"certified_authenticity": true
},
"favorite_count": 27,
"original_price": 326,
"similar_brands": [
{
"id": 62,
"name": "Burberry",
"department": "women"
},
{
"id": 90,
"name": "Diesel",
"department": "women"
},
{
"id": 204,
"name": "Lacoste",
"department": "women"
},
{
"id": 305,
"name": "Prada",
"department": "women"
}
],
"department_tags": [
"handbags",
"women",
"designer"
],
"is_peer_to_peer": false,
"discount_percent": 8,
"additional_description": null
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"item_number": [
"Send an item number or a product url."
]
},
"message": "The request validation failed"
}Item Not Found
thredUP has no item with this number. It may be sold or removed. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "thredUP has no item with this item number. It may be sold or removed."
},
"success": false
}Source Unavailable
thredUP did not give a usable answer after the retries. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "upstream_unavailable",
"message": "thredUP is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.