Skip to main content
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.

Quickstart

Make your first API call in under five minutes

Authentication

Get your API key and authenticate every request

API Reference

Browse all endpoints with parameters and examples

Pricing & Billing

Understand pay-per-call costs and prepaid balance

​
How it works

Noteboxd uses a pay-per-call model. Each request costs between 1¢ and 25¢ and is billed against a prepaid balance tied to your project. There are no subscriptions — you top up your balance and spend only what you use.
1

Create a project

Sign in to the Noteboxd developer portal and create a new project to receive your API key (nb_live_...).
2

Add a prepaid balance

Top up your project’s balance from the billing section of the portal. Calls are deducted automatically as you make requests.
3

Make your first request

Pass your API key in the Authorization: Bearer header and query the API. See the Quickstart for a working example.
4

Explore the data

Browse fragrances, notes, brands, and charts to build the experience you have in mind.

​
Explore the API

Fragrances

Profiles, reviews, similarity, wearing stats, batch, and enrichment

Search

Universal cross-entity search and trending data

Notes & Accords

Olfactory notes and accord family data

Brands

Brand profiles and full fragrance catalogues

Perfumers

Perfumer profiles and top creations

Charts

Ranked leaderboards and trending lists