| title | Noteboxd Public API: Fragrance, Brand, and Perfumer Data |
|---|---|
| sidebarTitle | Home |
| description | Explore the Noteboxd Public API: fragrance profiles, olfactory notes, accords, brand catalogues, perfumer portfolios, and chart data for your app. |
The Noteboxd API gives you programmatic access to one of the most comprehensive fragrance databases available. Whether you're building a recommendation engine, a discovery app, or enriching an e-commerce catalogue, you can query fragrance profiles, olfactory notes, accord families, brand catalogues, perfumer portfolios, and community-powered wearing stats — all over a simple REST API.
Make your first API call in under five minutes Get your API key and authenticate every request Browse all endpoints with parameters and examples Understand pay-per-call costs and prepaid balanceNoteboxd bills successful calls per endpoint. The free tier includes 50 calls per day with no card. Pay-as-you-go calls cost between 1¢ and 25¢ and are drawn from a prepaid balance. Failed calls are not billed.
Sign in to the [Noteboxd developer portal](https://developers.noteboxd.com), create a project, and create an API key (`nb_live_...`). Copy the secret when it is shown — it is not displayed again. The free tier covers 50 calls per day. For higher volume, add a prepaid balance. Successful pay-as-you-go calls are deducted automatically. Pass your API key in the `Authorization: Bearer` header and query the API. See the [Quickstart](/quickstart) for a working example. Browse [fragrances](/api-reference/fragrances/list), [notes](/api-reference/notes/list), [brands](/api-reference/brands/get), and [charts](/api-reference/charts/list) to build the experience you have in mind. Profiles, reviews, similarity, wearing stats, batch, and enrichment Universal cross-entity search and trending data Olfactory notes and accord family data Brand profiles and full fragrance catalogues Perfumer profiles and top creations Ranked leaderboards and trending lists