The Ultimate Fragrance Data API
Structured JSON for 13000+ 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.
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
}
]
}
The Most Comprehensive Fragrance Data API. Period.
Unleash the full potential of fragrance data with Fragella. Our API provides an unparalleled depth of information, structured for easy integration.
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.
13 000+ Fragrances
New 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)
Built on a Modern, Scalable Stack
We use industry-leading services to ensure reliability and performance.
