Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/notes — Paginate through all olfactory notes in the Noteboxd database. Each result includes a slug, display name, and olfactory family. Costs 1¢ per call.
GET /v1/notes
https://api.noteboxd.comAuthorization: Bearer nb_live_YOUR_KEY
1.20. Maximum 50.curl -G https://api.noteboxd.com/v1/notes \
-H "Authorization: Bearer nb_live_YOUR_KEY" \
--data-urlencode "page=1" \
--data-urlencode "limit=20"
{
"data": [
{ "slug": "bergamot", "name": "Bergamot", "family": "Citrus" },
{ "slug": "oud", "name": "Oud", "family": "Woody" },
{ "slug": "rose", "name": "Rose", "family": "Floral" }
],
"pagination": { "page": 1, "limit": 20, "total": 1240 }
}
slug you can pass directly to GET /v1/notes/{slug} to retrieve its full profile, description, and top fragrances that feature it.| 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 |