{"openapi":"3.2.0","info":{"title":"Noteboxd Public API","version":"1.0.0","description":"Fragrance, brand, note, perfumer, and chart data from Noteboxd. Authenticate with a project API key (`Authorization: Bearer nb_live_...`). Calls are billed per-endpoint against your prepaid balance and share a per-account daily rate-limit pool.","termsOfService":"https://www.noteboxd.com/terms","contact":{"name":"Noteboxd Developer Support","url":"https://www.noteboxd.com/developers"},"license":{"name":"Proprietary — Noteboxd API Terms","url":"https://www.noteboxd.com/terms"}},"servers":[{"url":"https://api.noteboxd.com","description":"Production"}],"tags":[{"name":"Fragrances","description":"Fragrance profiles, reviews, similarity, wearing stats, and batch/enrichment."},{"name":"Search","description":"Cross-entity search and trending queries."},{"name":"Brands","description":"Brand profiles and their catalogues."},{"name":"Perfumers","description":"Perfumer profiles and top creations."},{"name":"Notes","description":"Olfactory notes and the fragrances that feature them."},{"name":"Accords","description":"Accord families."},{"name":"Charts","description":"Ranked chart leaderboards."}],"security":[{"bearerAuth":[]}],"paths":{"/v1/search":{"get":{"operationId":"search","summary":"Universal cross-entity search","description":"Universal cross-entity search. Cost: 1¢ per call.","tags":["Search"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["fragrance","note","brand","perfumer","collection"]}},{"name":"limit","in":"query","required":true,"schema":{"default":20,"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/trending":{"get":{"operationId":"getTrending","summary":"Trending queries, fragrances, notes","description":"Trending queries, fragrances, notes. Cost: 1¢ per call.","tags":["Search"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/charts":{"get":{"operationId":"listCharts","summary":"List available chart rankings","description":"List available chart rankings. Cost: 1¢ per call.","tags":["Charts"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/charts/{slug}":{"get":{"operationId":"getChart","summary":"Full chart leaderboard","description":"Full chart leaderboard. Cost: 1¢ per call.","tags":["Charts"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Resource slug (e.g. `chanel`, `oud`, `top-rated`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances":{"get":{"operationId":"listFragrances","summary":"Search/filter with pagination","description":"Search/filter with pagination. Cost: 1¢ per call.","tags":["Fragrances"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"brand","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"note","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"family","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"priceRange","in":"query","required":false,"schema":{"type":"string","enum":["BUDGET","MIDRANGE","PREMIUM"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":true,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/{id}":{"get":{"operationId":"getFragrance","summary":"Full profile (notes, accords, score, perfumer)","description":"Full profile (notes, accords, score, perfumer). Cost: 1¢ per call.","tags":["Fragrances"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Fragrance id or slug (e.g. `tom-ford/oud-wood`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/{id}/reviews":{"get":{"operationId":"listFragranceReviews","summary":"Community reviews (paginated)","description":"Community reviews (paginated). Cost: 1¢ per call.","tags":["Fragrances"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Fragrance id or slug (e.g. `tom-ford/oud-wood`).","schema":{"type":"string"}},{"name":"page","in":"query","required":true,"schema":{"default":1,"type":"integer","minimum":1,"maximum":10000}},{"name":"limit","in":"query","required":true,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/{id}/similar":{"get":{"operationId":"listSimilarFragrances","summary":"Similar fragrances by accord profile","description":"Similar fragrances by accord profile. Cost: 2¢ per call.","tags":["Fragrances"],"x-price-cents":2,"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Fragrance id or slug (e.g. `tom-ford/oud-wood`).","schema":{"type":"string"}},{"name":"limit","in":"query","required":true,"schema":{"default":12,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/{id}/wearing-stats":{"get":{"operationId":"getFragranceWearingStats","summary":"Aggregate wearing data (seasons, moods)","description":"Aggregate wearing data (seasons, moods). Cost: 2¢ per call.","tags":["Fragrances"],"x-price-cents":2,"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Fragrance id or slug (e.g. `tom-ford/oud-wood`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/compare":{"get":{"operationId":"compareFragrances","summary":"AI comparison of two fragrances (shared/distinct notes, scores, grounded synthesis)","description":"AI comparison of two fragrances (shared/distinct notes, scores, grounded synthesis). Cost: 3¢ per call.","tags":["Fragrances"],"x-price-cents":3,"security":[{"bearerAuth":[]}],"parameters":[{"name":"a","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"First fragrance id"}},{"name":"b","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Second fragrance id (must differ from a)"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/{id}/review-digest":{"get":{"operationId":"getFragranceReviewDigest","summary":"AI digest of a fragrance's community reviews","description":"AI digest of a fragrance's community reviews. Cost: 5¢ per call.","tags":["Fragrances"],"x-price-cents":5,"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Fragrance id or slug (e.g. `tom-ford/oud-wood`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/brands/{slug}":{"get":{"operationId":"getBrand","summary":"Brand profile + top fragrances","description":"Brand profile + top fragrances. Cost: 1¢ per call.","tags":["Brands"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Resource slug (e.g. `chanel`, `oud`, `top-rated`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/brands/{slug}/fragrances":{"get":{"operationId":"listBrandFragrances","summary":"Full paginated catalogue for brand","description":"Full paginated catalogue for brand. Cost: 1¢ per call.","tags":["Brands"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Resource slug (e.g. `chanel`, `oud`, `top-rated`).","schema":{"type":"string"}},{"name":"page","in":"query","required":true,"schema":{"default":1,"type":"integer","minimum":1,"maximum":10000}},{"name":"limit","in":"query","required":true,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/perfumers/{slug}":{"get":{"operationId":"getPerfumer","summary":"Perfumer profile + top creations","description":"Perfumer profile + top creations. Cost: 1¢ per call.","tags":["Perfumers"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Resource slug (e.g. `chanel`, `oud`, `top-rated`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/notes":{"get":{"operationId":"listNotes","summary":"Browse/filter notes by family","description":"Browse/filter notes by family. Cost: 1¢ per call.","tags":["Notes"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"family","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"sort","in":"query","required":true,"schema":{"default":"popular","type":"string","enum":["popular","name"]}},{"name":"limit","in":"query","required":true,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/notes/{slug}":{"get":{"operationId":"getNote","summary":"Note profile + top fragrances","description":"Note profile + top fragrances. Cost: 1¢ per call.","tags":["Notes"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Resource slug (e.g. `chanel`, `oud`, `top-rated`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/accords":{"get":{"operationId":"listAccords","summary":"List accords","description":"List accords. Cost: 1¢ per call.","tags":["Accords"],"x-price-cents":1,"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/fragrances/batch":{"post":{"operationId":"batchGetFragrances","summary":"Up to 50 IDs in one call","description":"Up to 50 IDs in one call. Cost: 25¢ per call.","tags":["Fragrances"],"x-price-cents":25,"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1}}},"required":["ids"],"additionalProperties":false}}}}}},"/v1/fragrances/enrich":{"post":{"operationId":"enrichFragrance","summary":"Full enrichment (notes+accords+reviews+similar)","description":"Full enrichment (notes+accords+reviews+similar). Cost: 10¢ per call.","tags":["Fragrances"],"x-price-cents":10,"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","minLength":1},"similarLimit":{"type":"integer","minimum":1,"maximum":20},"reviewLimit":{"type":"integer","minimum":1,"maximum":20}},"required":["id"],"additionalProperties":false}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"nb_live_...","description":"Project API key issued from the Noteboxd developer portal. Send as `Authorization: Bearer nb_live_...`."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string"},"details":{"description":"Optional additional context."}}}}}},"headers":{"X-RateLimit-Limit":{"description":"Your account's daily call limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Calls remaining in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix epoch seconds when the window resets.","schema":{"type":"integer"}}},"responses":{"BadRequest":{"description":"Invalid query parameters or request body (code: INVALID_QUERY).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing or invalid API key (code: MISSING_API_KEY / INVALID_API_KEY).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"Insufficient prepaid balance (code: INSUFFICIENT_BALANCE).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The requested resource does not exist (code: NOT_FOUND).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequests":{"description":"Rate limit exceeded: too many calls (code: RATE_LIMIT_EXCEEDED) or too many distinct records accessed today (code: RECORD_CAP_EXCEEDED). Both include a Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Unexpected server error (code: INTERNAL_ERROR).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}