> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noteboxd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Noteboxd Public API: Fragrance, Brand, and Perfumer Data

> 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.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first API call in under five minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Get your API key and authenticate every request
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/fragrances/list">
    Browse all endpoints with parameters and examples
  </Card>

  <Card title="Pricing & Billing" icon="circle-dollar-to-slot" href="/concepts/pricing">
    Understand pay-per-call costs and prepaid balance
  </Card>
</CardGroup>

## 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.

<Steps>
  <Step title="Create a project">
    Sign in to the [Noteboxd developer portal](https://developers.noteboxd.com) and create a new project to receive your API key (`nb_live_...`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Make your first request">
    Pass your API key in the `Authorization: Bearer` header and query the API. See the [Quickstart](/quickstart) for a working example.
  </Step>

  <Step title="Explore the data">
    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.
  </Step>
</Steps>

## Explore the API

<CardGroup cols={3}>
  <Card title="Fragrances" icon="flask" href="/api-reference/fragrances/list">
    Profiles, reviews, similarity, wearing stats, batch, and enrichment
  </Card>

  <Card title="Search" icon="magnifying-glass" href="/api-reference/search/search">
    Universal cross-entity search and trending data
  </Card>

  <Card title="Notes & Accords" icon="leaf" href="/api-reference/notes/list">
    Olfactory notes and accord family data
  </Card>

  <Card title="Brands" icon="building" href="/api-reference/brands/get">
    Brand profiles and full fragrance catalogues
  </Card>

  <Card title="Perfumers" icon="user" href="/api-reference/perfumers/get">
    Perfumer profiles and top creations
  </Card>

  <Card title="Charts" icon="chart-bar" href="/api-reference/charts/list">
    Ranked leaderboards and trending lists
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.