# Selfridges — 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 browse Selfridges fragrance products by keyword, category, or brand. Returns detailed product data including fragrance notes, scent tags, pricing, sizing, and product descriptions.

**Category:** E-commerce | **Website:** [selfridges.com/](https://selfridges.com/) | **Docs:** [parse.bot/marketplace/a492c042-7136-40b8-b21f-b7dcf6eeda87/selfridges-com-api](https://parse.bot/marketplace/a492c042-7136-40b8-b21f-b7dcf6eeda87/selfridges-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/selfridges/`
**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 details

Get full details for a specific Selfridges product by its URL. Returns comprehensive product information including fragrance notes, scent tags, pricing, and descriptions parsed from the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Selfridges product URL (e.g. 'https://www.selfridges.com/GB/en/product/maison-francis-kurkdjian-baccarat-rouge-540-eau-de-parfum-70ml_496-83022651-MFK1022302/'). Can be obtained from source_url in search_fragrances, list_fragrances_by_category, or list_fragrances_by_brand results. |

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

### List fragrances by brand

Browse fragrance products by brand name on Selfridges. Searches for products matching the brand name and returns detailed product objects. Results are most relevant when using the exact brand name as displayed on Selfridges (e.g. 'LE LABO', 'TOM FORD', 'MAISON FRANCIS KURKDJIAN').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name (e.g. 'LE LABO', 'TOM FORD', 'MAISON FRANCIS KURKDJIAN', 'DIOR'). |
| `limit` | integer | No | Maximum number of products to fetch details for. |

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

### List fragrances by category

Browse fragrance products by category slug on Selfridges. Returns detailed product objects from the first page of results. Known working category slugs include 'beauty/fragrance/womens-perfume' and 'beauty/fragrance/mens-aftershave'. Invalid categories return an input_not_found error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug path (e.g. 'beauty/fragrance/womens-perfume', 'beauty/fragrance/mens-aftershave', 'beauty/fragrance/discovery-sets'). |
| `limit` | integer | No | Maximum number of products to fetch details for. |

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

### Search fragrances

Search for fragrance products by keyword on Selfridges. Returns a list of detailed product objects with fragrance notes, scent tags, pricing, and more. Each result requires fetching the individual product page, so response time scales with the limit parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of products to fetch details for. |
| `query` | string | Yes | Search query (e.g. 'Baccarat Rouge 540', 'Tom Ford', 'Chanel No 5'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/selfridges/search-fragrances \
  -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.