SSENSE Product API Documentation 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.
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.
6 optional filters available.
string
Optional
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.
https://example.com/product
string
Optional
Numeric product id from the url or from a search result.
1234567890
string
Optional
SSENSE designer slug from the product url. Required with id.
example
string
Optional
Product slug from the product url. Required with id.
example
string
Optional
men or women. Required with id.
example
string
Optional
Storefront: US (USD, default), CA (CAD) or GB (GBP). Defaults to the storefront of the url.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
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": {
"url": [
"Send a product url, or id with brand, slug and gender."
]
},
"message": "The request validation failed"
}Not Found
No product has this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "SSENSE has no product with this id."
},
"success": false
}Upstream Unavailable
The store did not answer or sent a page Scrappa cannot read. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "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.