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

## Access

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

## 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/parse-amiparis-com-api-ee24e16e/get_ami_de_coeur_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/get_product_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/get_product_variants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/list_collection_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/list_collections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amiparis-com-api-ee24e16e/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```