# SSENSE Product API Documentation

<p><strong>SSENSE Product API Documentation</strong> Read one SSENSE product by url or id. The item has the final price, regular price and lowest price, the discount percent, every size with its SKU, GTIN, stock count and in-stock flag, the description, colour, composition, country of origin, model measurements, category, all photos in full size and the creation date. SSENSE shows no rating or review count, so none is returned. The price is per product, not per size. An unknown product returns 404 and costs nothing. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/ssense-api/ssense_product](https://scrappa.co/docs/ssense-api/ssense_product)
- **API group:** SSENSE API
- **Endpoint:** `GET https://scrappa.co/api/ssense/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 |
| --- | --- | --- | --- |
| `url` | string | No | SSENSE product url, for example https://www.ssense.com/en-us/women/product/gucci/black-rectangular-glasses/18946621. Send this or id with brand, slug and gender. |
| `id` | string | No | Numeric product id from the url or from a search result. |
| `brand` | string | No | SSENSE designer slug from the product url. Required with id. |
| `slug` | string | No | Product slug from the product url. Required with id. |
| `gender` | string | No | men or women. Required with id. |
| `country` | string | No | Storefront: US (USD, default), CA (CAD) or GB (GBP). Defaults to the storefront of the url. |

## Example response

```json
{
    "data": {
        "item": {
            "id": "18946621",
            "sku": "261451F004006",
            "url": "https://www.ssense.com/en-us/women/product/gucci/black-rectangular-glasses/18946621",
            "name": "Black Rectangular Glasses",
            "brand": "Gucci",
            "color": "Black",
            "model": {
                "size_worn": "UNI",
                "measurements": [
                    {
                        "cm": 76.2,
                        "inch": 30,
                        "name": "chest"
                    },
                    {
                        "cm": 57.79,
                        "inch": 22.75,
                        "name": "waist"
                    },
                    {
                        "cm": 43.18,
                        "inch": 17,
                        "name": "shoulder"
                    },
                    {
                        "cm": 88.9,
                        "inch": 35,
                        "name": "hip"
                    },
                    {
                        "cm": 172.09,
                        "inch": 67.75,
                        "name": "height"
                    }
                ]
            },
            "price": {
                "amount": 177,
                "currency": "USD"
            },
            "gender": "women",
            "images": [
                "https://img.ssensemedia.com/images/w_1280,c_limit,h_1920,f_jpg,q_auto:best/261451F004006_1/gucci-black-rectangular-glasses.jpg",
                "https://img.ssensemedia.com/images/w_1280,c_limit,h_1920,f_jpg,q_auto:best/261451F004006_2/gucci-black-rectangular-glasses.jpg",
                "https://img.ssensemedia.com/images/w_1280,c_limit,h_1920,f_jpg,q_auto:best/261451F004006_3/gucci-black-rectangular-glasses.jpg",
                "https://img.ssensemedia.com/images/w_1280,c_limit,h_1920,f_jpg,q_auto:best/261451F004006_4/gucci-black-rectangular-glasses.jpg"
            ],
            "on_sale": true,
            "category": {
                "id": 8,
                "slug": "glasses",
                "level": 4,
                "parent_ids": [
                    7,
                    1
                ]
            },
            "in_stock": true,
            "variants": [
                {
                    "sku": "261451F00400600",
                    "gtin": "889652570242",
                    "size": "UNI",
                    "stock": 2,
                    "in_stock": true,
                    "size_system": "UNI"
                }
            ],
            "created_at": "2026-02-23T16:53:07.000Z",
            "composition": "Acetate.",
            "description": "Rectangular acetate-frame optical glasses.\n\n\u00b7 Integrated nose pads\n\u00b7 Logo hardware at temples\n\u00b7 Includes pouch\n\u00b7 Size: 51.19 140",
            "lowest_price": {
                "amount": 177,
                "currency": "USD"
            },
            "original_price": {
                "amount": 385,
                "currency": "USD"
            },
            "discount_percent": 54,
            "country_of_origin": "Italy"
        },
        "country": "US",
        "currency": "USD"
    },
    "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 | Not Found | No product has this id. This response is not billable. |
| 503 | Upstream Unavailable | The store did not answer or sent a page Scrappa cannot read. 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)