# Hunkemoller — 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 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.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.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.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.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.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.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.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>"}'
```