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

## Access

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

## 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/parse-selfridges-com-api-a492c042/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-selfridges-com-api-a492c042/list_fragrances_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-selfridges-com-api-a492c042/list_fragrances_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-selfridges-com-api-a492c042/search_fragrances \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```