# Ssense — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse luxury fashion products and designers on SSENSE. Retrieve detailed product information including pricing, composition, sizing, and model measurements, and check real-time inventory availability across the full catalog.

**Category:** E-commerce | **Website:** [ssense.com/](https://ssense.com/) | **Docs:** [parse.bot/marketplace/3452a375-c22e-481c-8ce2-27a9c6aeb273/ssense-com-api](https://parse.bot/marketplace/3452a375-c22e-481c-8ce2-27a9c6aeb273/ssense-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ssense-com-api-3452a375/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_inventory

Get real-time inventory status for a specific product SKU. Returns whether the SKU is currently in stock. SKU values are obtained from get_product_details sizes[*].sku field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU identifier (from get_product_details sizes[*].sku), e.g. '262249M18000702' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ssense-com-api-3452a375/get_inventory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku":"<string>"}'
```

### get_product_details

Get detailed information for a product by its full SSENSE URL. Returns comprehensive product data including description, composition, sizing with SKUs, pricing, and model measurements. The product URL can be obtained from list_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full SSENSE product URL (e.g. https://www.ssense.com/en-us/men/product/acne-studios/brown-suede-saddle-loafers/19236851) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ssense-com-api-3452a375/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### list_designers

List all designers/brands, categories, and available colors for a given section. Returns navigation data including brand names with product counts, hierarchical category tree, and color filter options. Useful for discovering valid filter values for list_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `section` | string | No | Section to browse: men, women, everything-else |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ssense-com-api-3452a375/list_designers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"section":"<string>"}'
```

### list_products

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug (e.g. clothing, shoes, bags, accessories, jackets-coats, jeans, pants, tops, sweaters, shirts, shorts) |
| `colors` | string | No | Filter by color (e.g. black, white, gray) |
| `designers` | string | No | Filter by designer slug (e.g. rick-owens, acne-studios) |
| `page` | integer | No | Page number for pagination |
| `query` | string | No | Search query to filter products by keyword |
| `section` | string | No | Section to browse: men, women, everything-else |
| `sizes` | string | No | Filter by size (e.g. 30, 32, M, L) |
| `sort` | string | No | Sort order for results (e.g. price-asc, price-desc) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ssense-com-api-3452a375/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","colors":"<string>","designers":"<string>","page":"<integer>","query":"<string>","section":"<string>","sizes":"<string>","sort":"<string>"}'
```