Skip to main content
This page walks you through everything you need to go from zero to a live API response. You’ll create a project, add a prepaid balance, and make your first search call — all in under five minutes. No SDK required; a terminal and your API key are all you need.
1

Create a project

Sign in to the Noteboxd developer dashboard at developers.noteboxd.com. From the dashboard, create a new project — give it any name you like. Once created, navigate to the Keys section of the project and copy your API key. It will be prefixed with nb_live_.Keep this key safe. You’ll pass it as a Bearer token in every request you make to the API.
2

Add a prepaid balance

Noteboxd is billed pay-per-call. Before any request will succeed, you need to add a balance to your account. Head to the Billing section of the developer dashboard and top up your balance. The amount you add is held as credit, and each API call deducts the cost of that request automatically.You can add any amount — even a few dollars is enough to get started and explore the API.
3

Make your first search call

With your key and balance in place, run the following curl command in your terminal. This calls the /v1/search endpoint and searches across all entity types for “Chanel No 5”:
Replace nb_live_YOUR_KEY with the key you copied from your project’s Keys section.
4

Read the response

A successful response returns a results array containing matching fragrances, brands, notes, perfumers, and collections. Each result includes a type field so you know what kind of entity it is, along with its canonical id, name, and relevant metadata. Here’s an example of what you’ll see:
You can use the id from any result to look up the full record for that entity using the corresponding detail endpoint.
5

Explore further

Now that you’ve made your first call, here are a few good places to go next:
Each API call costs 1¢ and is deducted automatically from your prepaid balance. Make sure your balance is topped up before running calls in production. You can monitor usage and add funds at any time from the developer dashboard.