# Hunkemoller — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 Hunkemöller's product catalog by category, search for items, view detailed product information, and discover new arrivals with filtering options. Find store locations and compare products to shop for lingerie and intimate apparel across their collection.

**Category:** E-commerce | **Website:** [hunkemoller.com/](https://hunkemoller.com/) | **Docs:** [parse.bot/marketplace/51ebb843-2dd5-4946-842e-410ad4d788c3/hunkemoller-com-api](https://parse.bot/marketplace/51ebb843-2dd5-4946-842e-410ad4d788c3/hunkemoller-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get category filters

Get available filters for a category. Returns filter groups including product type, size, color, price range, favourite fits, and collection. Each filter has a title, type (list with options, or range with min/max).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category URL path, e.g. /bras/all-bras |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/get_category_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>"}'
```

### Get category products

Get paginated products for a category path. Returns product listings with name, SKU, price, images, and ratings. Offset-based pagination via start parameter; each page returns up to sz items from a total pool.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category URL path, e.g. /bras/all-bras |
| `start` | integer | No | Pagination offset |
| `sz` | integer | No | Number of products per page |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","start":"<integer>","sz":"<integer>"}'
```

### Get new arrivals

Get new arrival products for a category. Returns paginated product listings. Constructs the new-arrivals path from the category name (e.g. 'bras' → /bras/new-bras). Offset-based pagination via start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category name, e.g. bras, panties |
| `start` | integer | No | Pagination offset |
| `sz` | integer | No | Number of products per page |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","start":"<integer>","sz":"<integer>"}'
```

### Get product details

Get full details for a product by its slug or relative URL. Returns name, description, materials, sizes, pricing, ratings, images, similar and related products. Accepts both relative paths (e.g. /product-slug.html) and full hunkemoller.com URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Product URL path or slug, e.g. /super-comfort-bra-beige-306397.html |

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

### Get stores

Get all physical store locations worldwide. Returns store name, address, city, coordinates, opening hours, and current open/closed status. Single request returns all stores (no pagination needed).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/get_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search products

Search for products by keyword. Returns paginated results with product name, SKU, price, images, and ratings. Offset-based pagination via start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword |
| `start` | integer | No | Pagination offset |
| `sz` | integer | No | Number of results per page |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-hunkemoller-com-api-51ebb843/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","start":"<integer>","sz":"<integer>"}'
```