Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/fragrances//similar — Find fragrances with a matching accord fingerprint, sorted by similarity score. Costs 2¢ per call.
similarityScore from 0.0 to 1.0, where higher values indicate a closer accord match. This is useful for building “you might also like” recommendations, helping users discover alternatives, or suggesting affordable substitutes for expensive fragrances.
GET /v1/fragrances/{id}/similar
curl https://api.noteboxd.com/v1/fragrances/dior-sauvage/similar \
-H "Authorization: Bearer nb_live_YOUR_KEY"
{
"id": "dior-sauvage",
"similar": [
{ "id": "bleu-de-chanel", "name": "Bleu de Chanel", "brand": "Chanel", "similarityScore": 0.91 },
{ "id": "ysl-y", "name": "Y", "brand": "Yves Saint Laurent", "similarityScore": 0.87 }
]
}
| Field | Type | Description |
|---|---|---|
id | string | The fragrance ID used as the similarity anchor. |
similar | array | Array of similar fragrances, sorted by similarityScore descending. |
similar[].id | string | Unique identifier of the similar fragrance. |
similar[].name | string | Display name of the similar fragrance. |
similar[].brand | string | Brand of the similar fragrance. |
similar[].similarityScore | float | Accord-based similarity score from 0.0 (no similarity) to 1.0 (identical accord profile). |
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum number of requests allowed in the current window. |
X-RateLimit-Remaining | Number of requests remaining in the current window. |
X-RateLimit-Reset | Unix timestamp at which the rate limit window resets. |