# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/hunkemoller/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/hunkemoller/get-category-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hunkemoller/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hunkemoller/get-new-arrivals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hunkemoller/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hunkemoller/get-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hunkemoller/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","start":"<integer>","sz":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.