ssense.com APIssense.com ↗
Access SSENSE product listings, designer catalogs, pricing, sizing, and real-time inventory data via a structured API. 4 endpoints covering men, women, and more.
curl -X GET 'https://api.parse.bot/scraper/961cc1db-cd90-4a3b-8931-372d3c020097/list_products?page=1§ion=men' \ -H 'X-API-Key: $PARSE_API_KEY'
List products for a section (men, women, everything-else) with optional category and filters. Returns paginated results sorted by the site's default or specified order.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results |
| query | string | Search query to filter products by keyword |
| sizes | string | Filter by size (e.g. 30, 32, M, L) |
| colors | string | Filter by color (e.g. black, white, gray) |
| section | string | Section to browse: men, women, everything-else |
| category | string | Category slug (e.g. clothing, shoes, bags, accessories, jackets-coats, jeans, pants) |
| designers | string | Filter by designer slug (e.g. rick-owens, acne-studios) |
{
"type": "object",
"fields": {
"page": "integer current page number",
"total": "integer total number of matching products",
"products": "array of product objects with id, brand, name, gender, seo_keyword, url, price, and images",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"page": 1,
"total": 0,
"products": [
{
"id": "19236851",
"url": "/men/product/acne-studios/brown-suede-saddle-loafers/19236851",
"name": "Brown Suede Saddle Loafers",
"brand": "Acne Studios",
"price": {
"regular": 670,
"currency": "USD",
"formatted": "$670"
},
"gender": "men",
"images": [
"https://res.cloudinary.com/ssenseweb/image/upload/__IMAGE_PARAMS__/262129M231000_1.jpg"
],
"seo_keyword": "brown-suede-saddle-loafers"
}
],
"total_pages": 23
},
"status": "success"
}
}About the ssense.com API
The SSENSE API exposes 4 endpoints for querying luxury fashion product listings, detailed product data, designer and brand catalogs, and real-time SKU-level inventory status across SSENSE's men, women, and everything-else sections. The list_products endpoint supports filtering by designer slug, color, size, category, and keyword, returning paginated results with price and image data for each product.
Product Listings and Search
The list_products endpoint accepts a section parameter (men, women, everything-else) and an optional category slug such as clothing, shoes, or jeans. Results can be narrowed further with designers (e.g. rick-owens, acne-studios), colors, sizes, query (keyword search), and a sort order. Each page of results includes an array of product objects with fields for id, brand, name, gender, url, price, seo_keyword, and images, along with total and total_pages for pagination.
Product Details
get_product_details takes a full SSENSE product URL and returns a richer data shape: color, category, description, composition, a model object with measurements and size worn, a price object with currency, numeric amount, and formatted string, and a sizes array where each entry includes id, sku, size label, and an in_stock boolean. This endpoint is the right source for building a product detail page or feeding a price-tracking system.
Designer and Brand Catalog
list_designers returns navigation-level data for a given section: a brands array with each designer's id, name, seoKeyword, and docCount (number of products available), a hierarchical categories array with parent/child structure, and a colors array. It also returns countries configuration and default_country_languages, which reflect region-specific shipping and pricing context.
Inventory Checks
get_inventory accepts a SKU string obtained from get_product_details (via sizes[*].sku) and returns a skus object with granular inventory details plus a top-level inStock boolean. This is useful for monitoring size availability on specific products without re-fetching the full product record.
- Track price changes on specific luxury products by polling
get_product_detailsfor theprice.amountfield - Build a size-availability alerting system using
get_inventorywith SKUs fromget_product_details - Aggregate designer product counts from
list_designersto analyze brand breadth across sections - Filter
list_productsbydesignersandsizesto surface in-stock items for a specific brand and fit - Compile a structured catalog of SSENSE product images and metadata for a fashion lookbook or comparison tool
- Monitor new arrivals by querying
list_productswith asortparameter and comparing against a stored product list - Extract model measurements from
get_product_detailsto build a size-recommendation layer for specific products
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SSENSE have an official public developer API?+
What does the `get_product_details` endpoint return beyond basic listing data?+
list_products, get_product_details returns color, category, a model object with body measurements and the size worn by the model, a price object with currency and formatted string, a sizes array with per-size sku and in_stock status, and an images array. It requires the full SSENSE product URL as input.Can I retrieve customer reviews or ratings for products?+
How does pagination work in `list_products`?+
list_products endpoint accepts an integer page parameter and returns page (current), total_pages, and total (matching product count) alongside the products array. Iterate through pages by incrementing page until it reaches total_pages.Does the API expose sale or discount pricing?+
price object in get_product_details includes currency, a numeric amount, and a formatted price string. There is no dedicated field for original price or discount percentage currently returned. You can fork this API on Parse and revise it to surface sale price fields if the source exposes them.