# thredUP Item API Documentation

<p><strong>thredUP Item API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/thredup-api/thredup_product](https://scrappa.co/docs/thredup-api/thredup_product)
- **API group:** thredUP API
- **Endpoint:** `GET https://scrappa.co/api/thredup/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `item_number` | integer | No | 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. |
| `url` | string | No | A thredup.com product url that ends with the item number. Required unless you send an item number. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Item Not Found | thredUP has no item with this number. It may be sold or removed. This response is not billable. |
| 503 | Source Unavailable | thredUP did not give a usable answer after the retries. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)