# Chris Collins — 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.

> Search and discover Chris Collins fragrances with detailed information including prices, scent profiles, and fragrance notes broken down by top, heart, and base layers. Find your perfect fragrance by browsing the complete product catalog with comprehensive scent descriptions.

**Category:** E-commerce | **Website:** [www.chriscollins.com/](https://www.chriscollins.com/) | **Docs:** [parse.bot/marketplace/0bf8957a-f700-4c17-abf4-60f5350b47fc/chriscollins-com-api](https://parse.bot/marketplace/0bf8957a-f700-4c17-abf4-60f5350b47fc/chriscollins-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-chriscollins-com-api-0bf8957a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product

Retrieve full details for a single fragrance product by its URL handle. Returns name, pricing, scent description, and fragrance notes (top, heart, base). The handle is the URL slug (e.g. 'kingmaker-master-of-oud') obtainable from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product URL handle/slug (e.g. 'kingmaker-master-of-oud'). Obtainable from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chriscollins-com-api-0bf8957a/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>"}'
```

### search_products

Full-text search over Chris Collins fragrance products. Returns matching products with name, pricing, scent description, and fragrance notes (top, heart, base). Results are capped at 10 per query by the upstream API. Some products (sets, samples) may not have notes data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-10). |
| `query` | string | Yes | Search term to find products (e.g. 'oud', 'sunset', 'chocolate'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chriscollins-com-api-0bf8957a/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```
