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

# API v1 and the move to v2

> v1 stays available until 31 December 2026. Each /v1 endpoint, its price, and the /v2 endpoint that replaces it.

> [!NOTE]
>
> `https://api.noteboxd.com/v1/*` remains available for existing integrations under the [v1 API terms](https://www.noteboxd.com/legal/api-terms-v1). v1 routes and their current prices are unchanged. v1 usage is charged pay as you go from the same prepaid balance as v2. v1 stays available until 31 December 2026 and stops working after that date. See [Migrate from API v1](https://docs.noteboxd.com/guides/migrate-from-v1.md).

All `/v1/*` requests use `Authorization: Bearer nb_live_...`.

| Endpoint | v1 price | v2 endpoint and price |
| - | - | - |
| `GET /v1/search` | 1¢ | `GET /v2/search`: $0.005 plus $0.001 per result |
| `GET /v1/trending` | 1¢ | `GET /v2/trending`: \$0.030 |
| `GET /v1/fragrances` | 1¢ | `GET /v2/fragrances`: $0.005 basic or $0.010 detailed, per record |
| `GET /v1/fragrances/{id}` | 1¢ | `GET /v2/fragrances/{id}`: $0.005 basic or $0.010 detailed |
| `GET /v1/fragrances/{id}/reviews` | 1¢ | `GET /v2/fragrances/{id}/reviews`: $0.010 plus $0.003 per review |
| `GET /v1/fragrances/{id}/similar` | 2¢ | `GET /v2/fragrances/{id}/similar`: \$0.030 |
| `GET /v1/fragrances/{id}/wearing-stats` | 2¢ | `GET /v2/fragrances/{id}/wearing-stats`: \$0.025 |
| `GET /v1/fragrances/compare` | 3¢ | `GET /v2/fragrances/compare`: \$0.060 |
| `GET /v1/fragrances/{id}/review-digest` | 5¢ | `GET /v2/fragrances/{id}/review-digest`: \$0.050 |
| `POST /v1/fragrances/batch` | 25¢ for up to 50 | `POST /v2/fragrances/batch`: $0.005 basic or $0.010 detailed per record, up to 100 |
| `POST /v1/fragrances/enrich` | 10¢ | `POST /v2/fragrances/enrich`: $0.050 plus $0.003 per review |
| `GET /v1/brands/{slug}` | 1¢ | `GET /v2/brands/{slug}`: \$0.010 |
| `GET /v1/brands/{slug}/fragrances` | 1¢ | `GET /v2/brands/{slug}/fragrances`: $0.005 basic or $0.010 detailed, per record |
| `GET /v1/perfumers/{slug}` | 1¢ | `GET /v2/perfumers/{slug}`: \$0.010 |
| `GET /v1/notes` | 1¢ | `GET /v2/notes`: \$0.003 per note |
| `GET /v1/notes/{slug}` | 1¢ | `GET /v2/notes/{slug}`: \$0.010 |
| `GET /v1/accords` | 1¢ | `GET /v2/accords`: $0.002 per accord, or `GET /v2/accords/{slug}`: $0.005 |
| `GET /v1/charts` | 1¢ | `GET /v2/charts`: \$0.005 |
| `GET /v1/charts/{slug}` | 1¢ | `GET /v2/charts/{slug}`: $0.020 plus $0.001 per entry |

On v2, a `304 Not Modified` costs half of the prices above. v2 also adds monthly plans, cheaper revalidation, signed image links, and a cursor-paged accord list.


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