List All Available Fragrance Chart Rankings

Charts are curated ranked leaderboards maintained by the Noteboxd editorial team. This endpoint lists every available chart as a slug-and-title pair, giving you a complete map of what leaderboards exist before you fetch individual ones. Because new charts are added regularly — seasonal picks, community votes, genre deep-dives — you should call this endpoint dynamically rather than hardcoding a list of slugs in your application.

Endpoint

GET /v1/charts

Base URL: https://api.noteboxd.com
Cost: 1¢ per call
Authentication: Authorization: Bearer nb_live_YOUR_KEY

Parameters

This endpoint takes no query parameters.

Example Request

curl https://api.noteboxd.com/v1/charts \
  -H "Authorization: Bearer nb_live_YOUR_KEY"

Example Response

{
  "charts": [
    { "slug": "top-rated-all-time", "title": "Top Rated All Time" },
    { "slug": "most-popular-this-week", "title": "Most Popular This Week" },
    { "slug": "best-summer-fragrances", "title": "Best Summer Fragrances" }
  ]
}

Use the slug values returned here with GET /v1/charts/{slug} to fetch the full ranked leaderboard for any individual chart.

Rate Limiting

Every response includes the following headers to help you track your usage:

Header	Description
`X-RateLimit-Limit`	Total requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining before you hit the limit
`X-RateLimit-Reset`	Unix timestamp when the window resets

Fragrances

Search & Discovery

Catalog

List All Available Fragrance Chart Rankings

Endpoint

Parameters

Example Request

Example Response

Rate Limiting

​Endpoint

​Parameters

​Example Request

​Example Response

​Rate Limiting

Endpoint

Parameters

Example Request

Example Response

Rate Limiting