# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-frette-com-api-01d30b5b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-frette-com-api-01d30b5b/check_order_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/find_boutique \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_bath_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_bedding_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_collection_set \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-frette-com-api-01d30b5b/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","start":"<integer>","sz":"<integer>"}'
```