SSENSE 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.
What is the SSENSE 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.
curl -X GET 'https://api.parse.bot/scraper/961cc1db-cd90-4a3b-8931-372d3c020097/list_products?page=1§ion=men&category=clothing' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ssense-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ssense_api import Ssense, Section, Product, ProductDetail, Size, Designer
ssense = Ssense()
# Browse men's clothing products
for product in ssense.products.list(section=Section.MEN, category="clothing", sort="price-desc"):
print(product.name, product.brand, product.price.formatted)
break
# Get detailed product information
detail = ssense.productdetails.get(product_url="https://www.ssense.com/en-us/men/product/jil-sander/red-taffeta-jacket/19291011")
print(detail.name, detail.composition, detail.country_of_origin)
# Check inventory for each size
for size in detail.sizes:
inv = size.inventory()
print(size.size, size.sku, inv.in_stock)
# List available designers for women's section
for designer in ssense.designers.list(section=Section.WOMEN):
print(designer.name, designer.doc_count, designer.seo_keyword)
break
List products for a section with optional category and filters. Returns paginated results with 120 products per page. A category is recommended for reliable results; without one, the section landing page may not always include product data due to A/B testing on the site's rendering.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results (e.g. price-asc, price-desc) |
| 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, tops, sweaters, shirts, shorts) |
| 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": 10366,
"products": [
{
"id": "19291011",
"url": "/men/product/jil-sander/red-taffeta-jacket/19291011",
"name": "Red Taffeta Jacket",
"brand": "Jil Sander",
"price": {
"regular": 2250,
"currency": "USD",
"formatted": "$2250"
},
"gender": "men",
"images": [
"https://res.cloudinary.com/ssenseweb/image/upload/__IMAGE_PARAMS__/262249M180007_1.jpg"
],
"seo_keyword": "red-taffeta-jacket"
}
],
"total_pages": 87
},
"status": "success"
}
}About the SSENSE API
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.
The SSENSE API is a managed, monitored endpoint for ssense.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ssense.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ssense.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.