> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noteboxd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Compare Two Fragrances

> GET /v1/fragrances/compare — Compare two fragrances by id: shared and distinct notes, accords, scores, and a written synthesis. Costs 3¢ per call.

Compare two fragrances in one call. The response covers shared and distinct notes, accords, and scores, plus a written synthesis of how the two scents differ.

## Endpoint

```
GET /v1/fragrances/compare
```

**Cost:** 3¢ per call

## Query Parameters

**a** `string` *required*

First fragrance id.

**b** `string` *required*

Second fragrance id. Must be different from `a`.

## Example Request

```bash theme={null}
curl -G https://api.noteboxd.com/v1/fragrances/compare \
  -H "Authorization: Bearer nb_live_YOUR_KEY" \
  --data-urlencode "a=chanel-no-5" \
  --data-urlencode "b=dior-sauvage"
```

> [!NOTE]
>
> A call that returns `4xx` or `5xx` is not billed. See [Pricing](/concepts/pricing).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.