# Amiparis — 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 Ami Paris products, collections, and search their catalog to find items by name or discover new arrivals and signature collections. Access detailed product information including variants, images, and pricing across all available collections.

**Category:** E-commerce | **Website:** [amiparis.com/](https://amiparis.com/) | **Docs:** [parse.bot/marketplace/ee24e16e-c3d8-4862-a988-850f43c1a064/amiparis-com-api](https://parse.bot/marketplace/ee24e16e-c3d8-4862-a988-850f43c1a064/amiparis-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/amiparis/`
**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 ami de coeur collection

Retrieve products from the signature Ami De Coeur (heart logo) collection. Supports pagination. Each product includes full variant, image, and option data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of products per page, maximum 250. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amiparis/get-ami-de-coeur-collection \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get new arrivals

Retrieve newly arrived products. Optionally filter by gender for ready-to-wear items. Without a gender filter, returns all unisex new arrivals. Each product includes full variant, image, and option data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender filter: 'men' or 'women'. Omitting returns all new arrivals. |
| `limit` | integer | No | Number of products per page, maximum 250. |
| `page` | integer | No | Page number for pagination. |

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

### Get product

Retrieve full product details including variants, pricing, images, and options by product handle. The handle is the URL slug for a product, obtainable from search_products or list_collection_products results. Returns the complete product object with all variant SKUs, barcodes, weights, images with dimensions, and option configurations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product handle (URL slug). |

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

### Get product images

Retrieve the full product object with emphasis on all image URLs and metadata for a specific product. Each image includes id, src URL, width, height, alt text, and position. Internally calls the same product endpoint as get_product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product handle (URL slug), obtainable from search_products or list_collection_products results. |

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

### Get product variants

Retrieve the full product object with emphasis on all size and color variants for a specific product. Each variant includes id, title, price, sku, option values, availability, barcode, and weight. Internally calls the same product endpoint as get_product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product handle (URL slug), obtainable from search_products or list_collection_products results. |

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

### List collection products

List all products in a specific collection. Supports pagination via page number and limit. Each product includes full variant, image, and option data. Use list_collections to discover available collection handles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `collection_handle` | string | Yes | Collection handle (URL slug), obtainable from list_collections results. |
| `limit` | integer | No | Number of products per page, maximum 250. |
| `page` | integer | No | Page number for pagination. |

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

### List collections

Retrieve a list of all available collections with their handles, titles, descriptions, and product counts. Use collection handles to browse products within a specific collection via list_collection_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of collections per page, maximum 250. |
| `page` | integer | No | Page number for pagination. |

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

### Search products

Search for products using keywords via the Shopify predictive search API. Returns up to 10 matching products with basic details including title, handle, price, image, and availability. For full product details including all variants, call get_product with the returned handle.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results, maximum 10. |
| `query` | string | Yes | Search keyword or phrase. |

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

## 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.