# Frette — 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 Frette's luxury bedding and bath collections, search for products across categories, check order status, and find boutique locations worldwide. Access detailed product information, view new arrivals, and explore curated collection sets all in one place.

**Category:** E-commerce | **Website:** [frette.com/](https://frette.com/) | **Docs:** [parse.bot/marketplace/01d30b5b-4004-4096-bc74-074107f41748/frette-com-api](https://parse.bot/marketplace/01d30b5b-4004-4096-bc74-074107f41748/frette-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/frette/`
**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

### Check order status

Check order status without logging in.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order_email` | string | Yes | Email address used for the order |
| `order_number` | string | Yes | Order number |
| `zip_code` | string | Yes | Billing ZIP code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/frette/check-order-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"order_email":"<string>","order_number":"<string>","zip_code":"<string>"}'
```

### Find boutique

Locate Frette boutiques and flagship stores worldwide. Returns all store locations with coordinates. Optionally filter by store name, address, or city via case-insensitive substring match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Filter stores by name, address, or city (case-insensitive substring match). Omitting returns all stores. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/frette/find-boutique \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get bath products

Retrieve bath products from the bath-linens-shop-all category. Returns the first page of product tiles with name, price, URL, and color swatches.

**Estimated cost:** Metered

_No parameters required._

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

### Get bedding products

Retrieve bedding products from the bed-linens-shop-all category. Returns the first page of product tiles with name, price, URL, and color swatches.

**Estimated cost:** Metered

_No parameters required._

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

### Get category products

Browse products within a specific Frette category. Returns paginated product tiles with name, price, URL, and color swatches. Pagination is offset-based via the start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cgid` | string | Yes | Category ID (e.g., 'bed-linens-shop-all', 'bath-linens-shop-all', 'new-arrivals'). |
| `start` | integer | No | Offset for pagination. |
| `sz` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/frette/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"cgid":"<string>","start":"<integer>","sz":"<integer>"}'
```

### Get collection set

Retrieve the 'Shop the Collection Set' bundle details for a given product. Returns the collection items (matching duvet covers, shams, etc.) associated with the parent product. Not all products have a collection set; those without return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pid` | string | Yes | Parent product slug (e.g., 'grace-sheet-set'). |

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

### Get new arrivals

Retrieve the latest new arrivals from Frette. Returns the first page of product tiles with name, price, URL, and color swatches.

**Estimated cost:** Metered

_No parameters required._

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

### Get product detail

Fetch full product details for a single Frette product by product slug. Returns pricing, availability, dimensions, fabric, images, and variant attributes. Supports selecting specific color and size variants via query parameters that map to Demandware variation attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `color` | string | No | Selected color variant name (e.g., 'White', 'Milk'). |
| `pid` | string | Yes | Product slug from the URL path (e.g., 'grace-sheet-set', 'divine-duvet-cover'). |
| `size` | string | No | Selected size variant name (e.g., 'Queen', 'King', 'CalKing'). |

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

### Search products

Search for Frette products by keyword. Returns paginated product tiles with name, price, URL, and color swatches. Pagination is offset-based via the start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'sheet', 'towel', 'pillow'). |
| `start` | integer | No | Offset for pagination. |
| `sz` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/frette/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.