# Millerknoll — 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 MillerKnoll's collective brands and their complete product catalogs, search for specific items across the collection, and access detailed product information and market insights. Discover product categories by brand and get comprehensive details to make informed purchasing or business decisions.

**Category:** E-commerce | **Website:** [millerknoll.com/](https://millerknoll.com/) | **Docs:** [parse.bot/marketplace/311b96f0-6a3f-4c2b-9229-cdd5d00f316f/millerknoll-com-api](https://parse.bot/marketplace/311b96f0-6a3f-4c2b-9229-cdd5d00f316f/millerknoll-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/`
**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 all brands

Retrieve the complete list of all MillerKnoll collective brands including name, tagline, slug, product URL, and external site link. Returns the full brand roster in a single unpaginated response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/get-all-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get brand product categories

Retrieve all product categories available for a specific brand along with product counts. Categories are returned as facets from the product index. Useful for discovering what product types a given brand offers before browsing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_slug` | string | Yes | Brand slug identifying the brand. Accepted values: herman-miller, knoll, geiger, muuto, naughtone, hay, holly-hunt, maharam, dwr-collection, datesweiser, edelman, filzfelt, colebrook-bosson-saunders, spinneybeck, knoll-textiles. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/get-brand-product-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand_slug":"<string>"}'
```

### Get insights

Retrieve articles and editorial content from the MillerKnoll articles section. Returns article titles, descriptions, URLs, and thumbnail images in a single unpaginated response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/get-insights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product detail

Retrieve full details for a specific product by its slug or full pathname. Returns product metadata including name, brand, description, images, designer, features, collection, SKU, and specifications. Falls back to a name-based search if an exact pathname match is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug (e.g. 'aeron-chair') or full pathname (e.g. '/products/seating/office-chairs/aeron-chair'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get products by brand

Retrieve a paginated list of products for a specific brand. Returns product summaries with name, description, images, and URL. Use page and limit to control pagination (zero-indexed pages).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_slug` | string | Yes | Brand slug identifying the brand. Accepted values: herman-miller, knoll, geiger, muuto, naughtone, hay, holly-hunt, maharam, dwr-collection, datesweiser, edelman, filzfelt, colebrook-bosson-saunders, spinneybeck, knoll-textiles. |
| `limit` | integer | No | Number of products per page. |
| `page` | integer | No | Page number (0-indexed). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/get-products-by-brand \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand_slug":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Search products

Search products across all brands and categories using a keyword query. Returns paginated results with product summaries including name, brand, description, images, and URL. Zero-indexed pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | Yes | Search keyword (e.g. 'chair', 'desk', 'aeron'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/millerknoll/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

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