Welcome, developer!
Subscription Canceled
Your plan will remain active until the end of the current billing period.
API Playground
Interactively test the API endpoints directly from your dashboard. Your API key will be used automatically.
Your API Key
Use this key in the x-api-key header of your requests.
••••••••••••••••••••••••••••••••
Embeddable UI Widget
Use this Public Key to safely embed Fragella data directly into your website's frontend. Do not use your secret API key above for this.
Loading...
For security, the widget will only load on this exact domain (e.g., https://www.yourstore.com). Leave off trailing slashes.
<div class="fragella-inject-accords" data-fragrance-name="{{ product.title }}"></div>
<script src="https://cdn.fragella.com/enrich.js" data-client-id="YOUR_PUBLIC_KEY"></script>Paste this into your product page. Ensure your eCommerce platform injects the product title dynamically.
How to Use the API
curl --request GET \
--url 'https://api.fragella.com/api/v1/usage' \
--header 'x-api-key: YOUR_API_KEY'curl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances?search=Sauvage' \
--header 'x-api-key: YOUR_API_KEY'curl --get 'https://api.fragella.com/api/v1/fragrances' \
--header 'x-api-key: YOUR_API_KEY' \
--data-urlencode 'brand=Lattafa,Afnan' \
--data-urlencode 'gender=men,unisex' \
--data-urlencode 'notes=musk,amber' \
--data-urlencode 'page=1' \
--data-urlencode 'limit=10'Lattafa OR Afnan, men OR unisex, and both musk AND amber. Search text is optional with filters; omit unused filter fields.
Most popular first without search text; text searches rank by relevance. Maximum 10 results per page and 2 pages. Copy includes your API key.
Filter documentationcurl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances/similar?name=Sauvage&limit=3' \
--header 'x-api-key: YOUR_API_KEY'curl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances/match?accords=floral:100,fruity:90&top=Pear' \
--header 'x-api-key: YOUR_API_KEY'curl --request GET \
--url 'https://api.fragella.com/api/v1/brands/Dior?limit=2' \
--header 'x-api-key: YOUR_API_KEY'curl --request GET \
--url 'https://api.fragella.com/api/v1/notes?search=Bergamot&limit=3' \
--header 'x-api-key: YOUR_API_KEY'