The Ultimate Fragrance Data API
Designed to give you exactly what matters, Structured JSON for 13k+ fragrances, with full note breakdowns, accord percentages, longevity, sillage, season, occasion, pricing, brand info, and images.
NEW Trait Match & Similarity Search: find fragrance by accord %, notes, or discover similar fragrances.
By signing up, you agree to our Terms of Use and Privacy Policy.
See it in Action.
Trusted by developers building real apps, no fluff. Make a request. Get clean, structured JSON back. It's that simple.
Example Request
Query our fuzzy-search enabled endpoint to find the top result for "Sauvage".
# GET /api/v1/fragrances
curl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances?search=Sauvage&limit=1' \
--header 'x-api-key: YOUR_API_KEY'
// Sample Response (200 OK)
[
{
"Name": "Eau Sauvage",
"Brand": "Christian Dior",
"Image URL": "https/.../eau-sauvage.jpg",
"Gender": "men",
"Price": "152.99",
"Longevity": "55.6%",
"Sillage": "49.25%",
"General Notes": [
"Hedione", "Galbanum", "Petitgrain",
"Vetiver", "Pink Pepper"
],
"Main Accords": [
"aromatic", "citrus", "fresh spicy",
"woody", "earthy", "mossy", "green"
],
"Main Accords Percentage": {
"aromatic": "100%", "citrus": "93%",
"fresh spicy": "79%", "woody": "67%"
},
"Season Ranking": [
{ "name": "spring", 2.353 },
{ "name": "summer", 1.212 },
{ "name": "fall", 1.051 },
{ "name": "winter", 0.469 }
],
"Occasion Ranking": [
{ "name": "professional", 2.636 },
{ "name": "casual", 1.145 },
{ "name": "night out", 0 }
],
"Notes": {
"Top": [
{ "name": "Lemon", "imageUrl": "..." },
{ "name": "Bergamot", "imageUrl": "..." },
{ "name": "Basil", "imageUrl": "..." }
],
"Middle": [
{ "name": "Jasmine", "imageUrl": "..." },
{ "name": "Coriander", "imageUrl": "..." },
{ "name": "Patchouli", "imageUrl": "..." },
{ "name": "Sandalwood", "imageUrl": "..." }
],
"Base": [
{ "name": "Oakmoss", "imageUrl": "..." },
{ "name": "Vetiver", "imageUrl": "..." },
{ "name": "Musk", "imageUrl": "..." }
]
}
}
]
Example Request – Trait Match
Find the best scents that are at least 100 % floral, 90 % fruity, 80 % citrus, and contain specific notes in the top, middle, and base.
# GET /api/v1/fragrances/match
curl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances/match?accords=floral:100,fruity:90,citrus:80&top=Pear,Bitter%20Orange,Bergamot&middle=Freesia&base=Iso%20E%20Super&limit=3' \
--header 'x-api-key: YOUR_API_KEY'
// Sample Response (200 OK)
[
{
"Name": "Versace Dylan Purple",
"Brand": "Gianni Versace",
"Image URL": "https://d2k6fvhyk5xgx.cloudfront.net/images/versace-dylan-purple.jpg",
"Gender": "women",
"Price": "114.99",
"Longevity": "51.2%",
"Sillage": "43.75%",
"Main Accords": [
"floral", "fruity", "citrus", "amber" …
],
"Main Accords Percentage": {
"floral": "100%",
"fruity": "93%",
"citrus": "86%"
/* … */
},
"Season Ranking": [
{ "name": "spring", 2.384 },
{ "name": "fall", 2.066 },
{ "name": "summer", 2.019 },
{ "name": "winter", 1.120 }
],
"Occasion Ranking": [
{ "name": "casual", 2.980 },
{ "name": "night out", 1.418 },
{ "name": "professional", 1.192 }
],
"Notes": {
"Top": [
{ "name": "Pear", "imageUrl": "…" },
{ "name": "Bitter Orange", "imageUrl": "…" },
{ "name": "Bergamot", "imageUrl": "…" }
],
"Middle": [
{ "name": "Freesia", "imageUrl": "…" }
],
"Base": [
{ "name": "Iso E Super", "imageUrl": "…" }
]
}
}
]
Example Request – Find Similar
Find fragrances most similar to a given scent. The API fuzzy-searches for the best match and then ranks all others against it.
# GET /api/v1/fragrances/similar
curl --request GET \
--url 'https://api.fragella.com/api/v1/fragrances/similar?name=Sauvage&limit=3' \
--header 'x-api-key: YOUR_API_KEY'
// Sample Response (200 OK)
{
"similar_to": "Dior Sauvage",
"similar_fragrances": [
{
"Name": "Prada Luna Rossa Carbon",
"SimilarityScore": 0.8912
},
{
"Name": "Versace Dylan Blue",
"SimilarityScore": 0.7645
},
{
"Name": "Armaf Ventana Pour Homme",
"SimilarityScore": 0.7499
}
]
}
Experience Fragella for yourself, see how it performs in real-world applications, loved by hundreds of users
Curious about how all this powerful data comes to life? Explore our official Fragella app, powered by this very API! Discover new scents, track your collection, and connect with other fragrance enthusiasts.
Go to Fragella App
The Most Comprehensive Fragrance Data API. Period.
Unleash the full potential of fragrance data that actually matters. Our API provides an unparalleled depth of information, structured for easy integration. Trusted by developers building real apps, not just scraping data.
Granular Note Data
Top, Middle & Base notes arrive with icons so you can drop them straight into any UI.
Accord Percentages
Know exactly how dominant each accord is—down to the percent.
Season & Occasion Ranking
Instantly surface which scents shine in spring, winter, the office, or a night out.
Advanced Trait Match
Query by accord thresholds & precise notes to find the perfect fit.
Sillage & Longevity
Built-in performance scores for instant comparison charts.
Smart Fuzzy Search
Typos? Partial names? We still find the scent you meant.
Pricing & Brand Data
Live price points, brand info and gender tags included.
CDN-Hosted Images
Bottle shots & note icons delivered lightning-fast via CDN.
13k+ Fragrances of what matters
New quality releases hit the API the same week they reach the shelves.
Find the Right Plan for You
Start for free, then scale as you grow. All plans include full data access.
Pro
For production apps.
- 7,500 requests/month
- Overages Enabled
- Unused Requests Carry Over (cap 3000)