# Chris Collins — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/chris-collins/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/chris-collins/get-product \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/chris-collins/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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.