# Noteboxd

## Docs

- [Noteboxd: Fragrance Data API for Developers](https://docs.noteboxd.com/introduction.md): Noteboxd is a pay-per-call REST API for fragrance, brand, note, perfumer, accord, and chart data. Build discovery, recommendation, and enrichment features.
- [Get Started with the Noteboxd API](https://docs.noteboxd.com/quickstart.md): Learn how to authenticate and make your first Noteboxd API call in under five minutes with a working curl example.
- [Authenticate with the Noteboxd API](https://docs.noteboxd.com/authentication.md): Noteboxd uses project API keys passed as a Bearer token. Learn how to get your key, pass it correctly, and handle auth errors.
- [Noteboxd Data Model: Fragrances, Notes, and Accords](https://docs.noteboxd.com/concepts/data-model.md): Understand the core entities in the Noteboxd API — fragrances, brands, perfumers, notes, accords, and charts — and how they relate to each other.
- [API Pricing: Pay-Per-Call and Prepaid Balance](https://docs.noteboxd.com/concepts/pricing.md): Noteboxd charges per API call billed against your prepaid balance. Learn per-endpoint costs, how billing works, and how to manage your balance.
- [Rate Limits and Daily Call Quotas](https://docs.noteboxd.com/concepts/rate-limits.md): Noteboxd enforces a per-account daily rate limit. Learn how to read rate limit headers and handle 429 responses gracefully.
- [Search the Noteboxd API: Fragrances, Brands, and Notes](https://docs.noteboxd.com/guides/search-fragrances.md): Use the Noteboxd universal search endpoint to find fragrances, brands, notes, perfumers, and collections by keyword across the full database.
- [Enrich Fragrance Data with Notes, Reviews, and Similar](https://docs.noteboxd.com/guides/fragrance-enrichment.md): Use the Noteboxd enrich endpoint to fetch a fragrance's full profile — notes, accords, community reviews, and similar fragrances — in a single API call.
- [Find Similar Fragrances by Accord Profile — Noteboxd API](https://docs.noteboxd.com/guides/similarity.md): Use the Noteboxd similarity endpoint to discover fragrances with matching accord profiles — ideal for recommendation features and fragrance alternatives.
- [Noteboxd API Error Codes and Troubleshooting Guide](https://docs.noteboxd.com/errors.md): Reference for all Noteboxd API error codes, HTTP status codes, and recommended fixes to apply when your API requests return 4xx or 5xx responses.
- [Noteboxd API — Frequently Asked Questions from Developers](https://docs.noteboxd.com/faq.md): Answers to common questions about the Noteboxd API: pricing, authentication, rate limits, data freshness, slugs vs IDs, and how to get support.
- [List Fragrances — Browse the Paginated Catalogue](https://docs.noteboxd.com/api-reference/fragrances/list.md): GET /v1/fragrances — Browse all fragrances with pagination. Accepts page and limit parameters, returns an array of fragrance summaries.
- [Get Fragrance — Full Profile with Notes and Accords](https://docs.noteboxd.com/api-reference/fragrances/get.md): GET /v1/fragrances/{id} — Fetch a complete fragrance profile including notes, accords, community score, and perfumer attribution.
- [List Fragrance Reviews — Paginated Community Ratings](https://docs.noteboxd.com/api-reference/fragrances/reviews.md): GET /v1/fragrances/{id}/reviews — Retrieve paginated community reviews for a fragrance, including written text, rating, and post date.
- [Similar Fragrances — Accord-Based Similarity Search](https://docs.noteboxd.com/api-reference/fragrances/similar.md): GET /v1/fragrances/{id}/similar — Find fragrances with a matching accord fingerprint, sorted by similarity score. Costs 2¢ per call.
- [Fragrance Wearing Stats — Seasons, Moods, Occasions](https://docs.noteboxd.com/api-reference/fragrances/wearing-stats.md): GET /v1/fragrances/{id}/wearing-stats — Aggregate community wearing data: seasonal distribution, moods, occasions, and occasion tags.
- [Batch Get Fragrances — Fetch Up to 50 IDs Per Call](https://docs.noteboxd.com/api-reference/fragrances/batch.md): POST /v1/fragrances/batch — Fetch up to 50 fragrance profiles in a single request. Costs 25¢ flat and is more efficient than individual lookups.
- [Enrich Fragrance — Notes, Accords, Reviews, Similar](https://docs.noteboxd.com/api-reference/fragrances/enrich.md): POST /v1/fragrances/enrich — Single-call enriched profile including notes, accords, community reviews, and similar fragrances. Costs 10¢ per call.
- [Universal Search Across Fragrances, Brands & Notes](https://docs.noteboxd.com/api-reference/search/search.md): GET /v1/search — Cross-entity keyword search returning fragrances, brands, notes, perfumers, and collections in a single ranked results array. Costs 1¢ per call.
- [Trending Fragrances, Queries, and Notes — Live Feed](https://docs.noteboxd.com/api-reference/search/trending.md): GET /v1/trending — Fetch currently trending search queries, fragrances, and olfactory notes on Noteboxd. No parameters required. Costs 1¢ per call.
- [List All Available Fragrance Chart Rankings](https://docs.noteboxd.com/api-reference/charts/list.md): GET /v1/charts — Retrieve every available ranked chart as a slug-and-title pair. Use slugs with GET /v1/charts/{slug} to fetch full leaderboards. Costs 1¢ per call.
- [Get Ranked Chart Leaderboard by Slug](https://docs.noteboxd.com/api-reference/charts/get.md): GET /v1/charts/{slug} — Retrieve the full ranked leaderboard for a specific chart. Returns ordered fragrance entries with rank, name, brand, and score. Costs 1¢ per call.
- [Get Fragrance Brand Profile and Top Fragrances](https://docs.noteboxd.com/api-reference/brands/get.md): GET /v1/brands/{slug} — Fetch a brand's full profile including name, country, editorial description, and highest-rated fragrances on Noteboxd. Costs 1¢ per call.
- [List a Brand's Full Fragrance Catalogue — Paginated](https://docs.noteboxd.com/api-reference/brands/fragrances.md): GET /v1/brands/{slug}/fragrances — Browse the complete paginated fragrance catalogue for a specific brand, from flagship classics to limited editions. Costs 1¢ per call.
- [Get Perfumer Profile, Biography, and Top Creations](https://docs.noteboxd.com/api-reference/perfumers/get.md): GET /v1/perfumers/{slug} — Retrieve a perfumer's full profile including biography, nationality, and their highest-rated fragrance creations on Noteboxd. Costs 1¢ per call.
- [List All Olfactory Notes — Paginated Ingredient Browser](https://docs.noteboxd.com/api-reference/notes/list.md): 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 Olfactory Note Profile and Top Fragrances](https://docs.noteboxd.com/api-reference/notes/get.md): GET /v1/notes/{slug} — Retrieve an olfactory note's full profile including family classification, editorial description, and top-rated fragrances featuring it. Costs 1¢ per call.
- [List All Fragrance Accord Families — Slugs & Names](https://docs.noteboxd.com/api-reference/accords/list.md): GET /v1/accords — Retrieve all accord families used in fragrance classification, with stable slugs and display names for filters and UI labels. Costs 1¢ per call.


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