ETag tied to your account.
Catalogue data
Fragrances, brands, perfumers, notes, and accords, including list and batch endpoints, can be cached for as long as your plan allows:Image links
Image links are for showing images in your app or site, not for downloading or storing them on a server. The only exception is an Enterprise Embedded Data License. Use each link exactly as returned, including itsexp and sig parameters, and load it in a page or app view.
A signed link looks like this:
Data that changes often
These windows are the same on every plan:
When a cached response reaches the end of its window, delete it or revalidate it.
Revalidating with an ETag
Send theETag you saved in an If-None-Match header. If nothing changed, you get 304 Not Modified with no body, at half the list price. If the 304 is paid from your prepaid balance, your plan’s discount applies on top: 55% off on Starter, 65% on Growth, and 75% on Scale. The total discount never goes above 90%.
Search is not eligible for a 304.
Keeping data longer
On self-serve plans, cache only within these windows. You can keep bareid and slug values in your own records for as long as you like. Keeping catalogue data permanently, for example to seed your own product database or run your own search over Noteboxd fields, needs an Enterprise Embedded Data License. Email api@noteboxd.com.