List a Brand's Full Fragrance Catalogue

This endpoint returns the complete fragrance catalogue for a given brand, paginated for easy consumption. Unlike the topFragrances array on the brand profile, this listing is exhaustive — covering every fragrance Noteboxd has on record for that house, from flagship classics to limited editions. Use it to build brand catalogue pages, power autocomplete filters, or sync a brand’s full inventory into your own database.

Endpoint

GET /v1/brands/{slug}/fragrances

Base URL: https://api.noteboxd.com
Cost: 1¢ per call
Authentication: Authorization: Bearer nb_live_YOUR_KEY

Path Parameters

string

required

The unique identifier for the brand. Obtain brand slugs from the universal search endpoint using type=brand. Example: chanel.

Query Parameters

integer

The page of results to return. Defaults to 1. Use in conjunction with limit to paginate through the full catalogue.

integer

Number of fragrances to return per page. Defaults to 20. Maximum 50.

Example Request

curl -G https://api.noteboxd.com/v1/brands/chanel/fragrances \
  -H "Authorization: Bearer nb_live_YOUR_KEY" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"

Example Response

{
  "brand": "chanel",
  "data": [
    { "id": "chanel-no-5", "name": "No 5" },
    { "id": "chanel-chance", "name": "Chance" }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 148 }
}

Check the pagination.total field in the response to calculate the number of pages you need to fetch. For example, a brand with 148 fragrances and a limit of 50 requires 3 pages (ceil(148 / 50) = 3).

Rate Limiting

Every response includes the following headers to help you track your usage:

Header	Description
`X-RateLimit-Limit`	Total requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining before you hit the limit
`X-RateLimit-Reset`	Unix timestamp when the window resets

Fragrances

Search & Discovery

Catalog

List a Brand's Full Fragrance Catalogue — Paginated

Endpoint

Path Parameters

Query Parameters

Example Request

Example Response

Rate Limiting

​Endpoint

​Path Parameters

​Query Parameters

​Example Request

​Example Response

​Rate Limiting

Endpoint

Path Parameters

Query Parameters

Example Request

Example Response

Rate Limiting