The Ultimate Fragrance Data API

Designed to give you exactly what matters fast, Structured JSON for 74k+ fragrances, with full note breakdowns with occurrence and description, popularity tiers, price/value scores, data confidence levels, accord percentages, longevity, sillage, OilType, season, occasion, pricing, brand info, launch year, country, user rating, images/transparent images, andPurchase Link.

EXPLORE Trait Match & Similarity Search: find fragrance by accord, notes, or similar fragrances.

NEW Headless UI Widget launched! Integrate data directly into your store with zero backend coding required.

Get API Key Read the Docs

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.

Interactive Playground Demo

See how quickly you can get the data you need using advanced caching techniques

Access the Playground

Example Request - Fuzzy-search

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'

import requests

url = "https://api.fragella.com/api/v1/fragrances"
querystring = {"search": "Sauvage", "limit": "1"}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/fragrances',
  params: {search: 'Sauvage', limit: '1'},
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/fragrances?search=Sauvage&limit=1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
[
  {
    "_id": "EauSauvage",
    "Name": "Eau Sauvage",
    "Brand": "Christian Dior",
    "Year": "1966",
    "rating": "4",
    "Country": "France",
    "Confidence": "High",
    "Popularity": "High",
    "Price Value": "good_value",
    "Image URL": "https/.../eau-sauvage.jpg",
    "Image URL Transparent": "https/.../eau-sauvage.webp",
    "Image Fallbacks": [
    "https://...../eau-sauvage.jpg"
                    ],
   "Purchase URL": "https:....",
    "Gender": "men",
    "Price": "152.99",
    "Longevity": "Moderate",
    "Sillage": "Moderate",

    "OilType": "Eau de Parfum",

    "General Notes": [
      "Hedione", "Galbanum", "Petitgrain",
      "Vetiver", "Pink Pepper"
    ],
    "Main Accords": [
      "aromatic", "citrus", "fresh spicy",
      "woody", "earthy", "mossy", "green"
    ],
    "Main Accords Percentage": {  
      "aromatic": "Dominant",
      "citrus": "Dominant",
      "fresh spicy": "Prominent",
      "woody": "Prominent"
    },
    "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.

# 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'

import requests

url = "https://api.fragella.com/api/v1/fragrances/match"
querystring = {
    "accords": "floral:100,fruity:90,citrus:80",
    "top": "Pear,Bitter Orange,Bergamot",
    "middle": "Freesia",
    "base": "Iso E Super",
    "limit": "3"
}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/fragrances/match',
  params: {
    accords: 'floral:100,fruity:90,citrus:80',
    top: 'Pear,Bitter Orange,Bergamot',
    middle: 'Freesia',
    base: 'Iso E Super',
    limit: '3'
  },
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

$curl = curl_init();
$query = http_build_query([
  "accords" => "floral:100,fruity:90,citrus:80",
  "top" => "Pear,Bitter Orange,Bergamot",
  "middle" => "Freesia",
  "base" => "Iso E Super",
  "limit" => "3"
]);

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/fragrances/match?" . $query,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
[
  {
    "_id": "Versace-Dylan-Purple",
    "Name": "Versace Dylan Purple",
    "Brand": "Gianni Versace",
    "Year": "2022",
    "rating": "4",
    "Confidence": "High",
    "Popularity": "High",
    "Price Value": "good_value",

    "Country": "Italy",
    "Image URL": "https://cdn.fragella.com/images/versace-dylan-purple.jpg",
    "Image URL Transparent": "https://cdn.fragella.com/images/versace-dylan-purple.webp",
    "Image Fallbacks": [
    "https://...../eau-sauvage.jpg"
                    ],
   "Purchase URL": "https:....",

    "Gender": "women",
    "Price": "114.99",
    "Longevity": "Moderate",
    "Sillage": "Moderate",

    "OilType": "Eau de Parfum",

    "Main Accords": [
      "floral", "fruity", "citrus", "amber", "woody"
    ],
    "Main Accords Percentage": { 
      "floral": "Dominant",
      "fruity": "Dominant",
      "citrus": "Dominant"
    },    "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'

import requests

url = "https://api.fragella.com/api/v1/fragrances/similar"
querystring = {"name": "Sauvage", "limit": "3"}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/fragrances/similar',
  params: {name: 'Sauvage', limit: '3'},
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/fragrances/similar?name=Sauvage&limit=3",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
{
  "similar_to": "Dior Sauvage",
  "similar_fragrances": [
    {
      "_id": "Prada-Luna-Rossa-Carbon",
      "Name": "Prada Luna Rossa Carbon",
      "Brand": "Prada",
      "Year": "2017",
      "rating": "4",
      "Longevity": "Long Lasting", 
      "Sillage": "Strong",   
      "Confidence": "Medium",
      "Popularity": "Medium",
      "Price Value": "good_value",  
      "OilType": "Eau de Toilette", 
      "General Notes": ["Bergamot", "Lavender", "Ambroxan"],
      "Main Accords": ["aromatic", "fresh spicy", "citrus", "musky"],
      "Notes": { /* ... full note pyramid ... */ },
      "SimilarityScore": 0.8912
    },
    {
      "_id": "Prada-Luna-Rossa-Carbon",
      "Name": "Versace Dylan Blue",
      "Brand": "Gianni Versace",
      "Year": "2016",
      "rating": "4",
      "Longevity": "Long Lasting", 
      "Sillage": "Strong",      
      "OilType": "Eau de Toilette", 
      "General Notes": ["Ambroxan", "Grapefruit", "Incense"],
      "Main Accords": ["amber", "aquatic", "citrus", "incense"],
      "Notes": { /* ... full note pyramid ... */ },
      "SimilarityScore": 0.7645
    }
  ]
}

Example Request - Brand Search

Retrieve all fragrances for a specific brand, such as "Dior".

# GET /api/v1/brands/Dior
curl --request GET \
  --url 'https://api.fragella.com/api/v1/brands/Dior?limit=2' \
  --header 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.fragella.com/api/v1/brands/Dior"
querystring = {"limit": "2"}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/brands/Dior',
  params: {limit: '2'},
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/brands/Dior?limit=2",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
[
    {
        "_id": "Prada-Luna-Rossa-Carbon",
        "Name": "Chirstian Dior Eau Sauvage Edt",
        "Brand": "Dior",
        "Year": "1966",
        "rating": "4",
        "Confidence": "High",
        "Popularity": "Very high",
        "Price Value": "Overpriced",
        "Country": "France",
        "Image URL": "https://.../chirstian-dior-eau-sauvage-edt.jpg",
        "Image URL Transparent": "https://.../chirstian-dior-eau-sauvage-edt.webp",
        "Gender": "Men",
        "Price": "69.00",
        "Longevity": "Moderate",
        "Sillage": "Moderate",
        "OilType": "Eau de Parfum",
        "Main Accords": ["aromatic", "citrus", "fresh spicy", ...],
        "Notes": {
            "Top": [{"name":"Lemon", "imageUrl":"..."}, ...],
            "Middle": [{"name":"Jasmine", "imageUrl":"..."}, ...],
            "Base": [{"name":"Oakmoss", "imageUrl":"..."}, ...]
        }
    },
    {
        "_id": "Prada-Luna-Rossa-Carbon",
        "Name": "Christian Dior Dior Sauvage Edp",
        "Brand": "Dior",
        "Image URL": "https://.../christian-dior-dior-sauvage-edp.jpg",
        "Image URL Transparent": "https://.../christian-dior-dior-sauvage-edp.webp",
        "Gender": "Men",
        "Price": "85.00",
        "Longevity": "75.2%",
        "Sillage": "66.0%",
        
        "OilType": "Eau de Parfum",

        "Main Accords": ["fresh spicy", "citrus", "amber", ...],
        "Notes": {
            "Top": [{"name":"Bergamot", "imageUrl":"..."}],
            "Middle": [{"name":"Sichuan Pepper", "imageUrl":"..."}, ...],
            "Base": [{"name":"Ambroxan", "imageUrl":"..."}, ...]
        }
    }
]

Example Request - Note Search

Search for individual fragrance notes to get their description and usage data.

# GET /api/v1/notes
curl --request GET \
  --url 'https://api.fragella.com/api/v1/notes?search=Bergamot&limit=3' \
  --header 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.fragella.com/api/v1/notes"
querystring = {"search": "Bergamot", "limit": "3"}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/notes',
  params: {search: 'Bergamot', limit: '3'},
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/notes?search=Bergamot&limit=3",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
[
    {
        "name": "Bergamot",
        "occurence": 3549,
        "description": "Bergamot offers a bright, uplifting citrus scent with subtle floral undertones. It's commonly used as a top note to add freshness and vitality to perfumes.",
        "imageUrl": "https://cdn.fragella.com/note_images/Bergamot.png"
    },
    {
        "name": "Sicilian Bergamot",
        "occurence": 55,
        "description": "Sicilian Bergamot is a brighter, slightly sweeter, and less bitter citrus scent compared to Calabrian Bergamot, offering a sparkling and uplifting top note.",
        "imageUrl": "https://cdn.fragella.com/note_images/Sicilian%20Bergamot.png"
    },
    {
        "name": "White Bergamot",
        "occurence": 2,
        "description": "White Bergamot offers a light, fresh, and subtly sweet citrus scent, cleaner and less tart than traditional bergamot, with an ethereal radiance.",
        "imageUrl": "https://cdn.fragella.com/note_images/White%20Bergamot.png"
    }
]

Example Request - Accord Search

Search for primary scent families (accords) to understand fragrance character.

# GET /api/v1/accords
curl --request GET \
  --url 'https://api.fragella.com/api/v1/accords?search=Woody' \
  --header 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.fragella.com/api/v1/accords"
querystring = {"search": "Woody"}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.fragella.com/api/v1/accords',
  params: {search: 'Woody'},
  headers: {'x-api-key': 'YOUR_API_KEY'}
};

axios.request(options).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fragella.com/api/v1/accords?search=Woody",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Sample Response (200 OK)
[
    {
        "name": "woody",
        "occurence": 8234,
        "description": "Woody accords are rich and warm, often evoking the scent of various woods like sandalwood, cedar, and vetiver. They provide depth and longevity to fragrances, making them a staple in many perfumes."
    }
]

No Backend Required

Headless UI Widget

Integrate directly into Shopify, WooCommerce, or any static website without server-side code. Our headless widget binds data directly to your HTML attributes. Bring your CSS, we inject the data.

Works with:

Shopify

WooCommerce

HTML

Secure & Whitelisted Public keys restricted to your domain. No quota draining.
CSS-Agnostic Inherits your store's native styling. Complete design freedom.
Dynamic Binding Auto-loads fragrance data by product title via templates.

View Documentation

<!-- Drop into your product template -->
<div class="fragella-data-container" 
     data-fragrance-name="{{ product.title }}">
  
  <h4>Performance</h4>
  <p>Longevity: <span data-fragella-text="Longevity"></span></p>
  <p>Sillage: <span data-fragella-text="Sillage"></span></p>

  <h4>Main Accords</h4>
  <!-- Injects <span class="fragella-list-item"> -->
  <div data-fragella-list="Main Accords"></div>

</div>

<!-- Load the script -->
<script src="https://cdn.fragella.com/enrich.js" 
        data-client-id="pub_YOUR_KEY"></script>

Experience Fragella for yourself, see how it performs in real-world applications, loved by thousands 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.

Go beyond basic data. Our API delivers rich, structured insights that power sophisticated fragrance applications. See what makes us the developer's choice.

Unmatched Detail

Granular Note & Accord Data

Don't just get a list of notes. Get a full breakdown of top, middle, and base notes, complete with descriptions, occurrence data, and CDN-hosted icons. Plus, understand a scent's character with precise accord percentages.

Full note pyramid (Top, Middle, Base).
Note descriptions and usage frequency.
Accord percentages to quantify scent profiles.

// Response Snippet
"Main Accords Percentage": {
"aromatic": "Dominant",
  "citrus": "Dominant",
  "fresh spicy": "Prominent"
},
"Notes": {
  "Top": [
    { "name": "Lemon", "imageUrl": "..." },
    { "name": "Bergamot", "imageUrl": "..." }
  ],
  "Middle": [ ... ],
  "Base": [ ... ]
}

Powerful Discovery

Advanced Trait & Similarity Search

Empower users to find exactly what they're looking for. Our API allows you to query by specific note combinations, accord thresholds, or find fragrances remarkably similar to a known favorite.

Find scents by accord strength (e.g., "at least 80% woody").
Query by notes present in the top, middle, or base.
Discover close alternatives with a similarity score.

# Find fragrances similar to Sauvage
curl 'https://.../similar?name=Sauvage' \
     -H 'x-api-key: YOUR_KEY'

# Find floral scents with Pear & Freesia
curl 'https://.../match?accords=floral:100' \
     '&top=Pear&middle=Freesia' \
     -H 'x-api-key: YOUR_KEY'

Actionable Insights

Performance & Context Ranking

Provide real-world advice. Our ranked data helps users choose the right fragrance for the right situation, whether it's based on performance, season, or occasion.

Reliable sillage and longevity scores.
Clear concentration data (EDT, EDP, Extrait).
Ranked scores for seasons (Spring, Summer, etc.).
Occasion suitability (professional, casual, night out).
Includes Popularity Tiers (Low to Very High), Price-Value metrics, and Confidence Scores for every entry.

// Response Snippet
"Confidence": "High",
"Popularity": "High",
"Price Value": "ok",
"Longevity": "Moderate",
"Sillage": "Moderate",
"OilType": "Eau de Parfum",
"Season Ranking": [
  { "name": "spring", 2.353 },
  { "name": "summer", 1.212 },
  ...
],
"Occasion Ranking": [
  { "name": "professional", 2.636 },
  ...
]

Plus, All The Essentials

We've included everything you need for a complete, robust application, right out of the box.

Smart Fuzzy Search

Typos? Partial names? We still find the scent you meant.

Pricing & Purchase Links

Includes pricing data and direct purchase links for monetization.

CDN-Hosted Assets

Lightning-fast bottle shots, transparent images, and note icons.

74k+ Curated Fragrances

A high-quality with launch years, country, ratings and relevant database that's constantly growing.

Fast & Reliable

Built for production with low latency and high uptime.

Excellent Documentation

Clear, comprehensive docs to get you building in minutes.

Powered by Fragella

See how developers are using our data to build the next generation of fragrance tech, and learn how to get your own project featured.

+12

Join the Showcase Up to 50% off for students & creators

Find the Right Plan for You

Start for free, then scale as you grow. All plans include full data access. We're a small team of developers passionate about infrastructure and technology. We don't operate for profit, every dollar goes directly into maintaining and improving our servers and services.

Monthly

Yearly (Save 18%)

Free

For hobbyists and exploration.

20 requests/month

Get Started

Basic

For small projects.

$12

/month

5,000 requests/month

Get Started

Best Value

Pro

For production apps.

$49 /month

20,000 requests/month
Overages (+$0.01/req)
Carry-over (cap 3000)

Get Started

Pay As You Go

For variable usage.

$0.005 /request

Includes a $2 monthly base fee for maintaining API infrastructure and availability.

Ultra-low $2/mo base fee + flexible usage

Get Started

Looking for more?

For custom request limits, dedicated support, and service-level agreements, our Enterprise plan has you covered.

Contact Sales

Common Questions

Discover frequently asked questions by new users of Fragella API. We are constantly updating our features to provide you with the latest and most professional data.

Built on a Modern, Scalable Stack

We use industry-leading services to ensure reliability and performance.

The Ultimate Fragrance Data API

See it in Action.

Interactive Playground Demo

Example Request - Fuzzy-search

Example Request - Trait Match

Example Request - Find Similar

Example Request - Brand Search

Example Request - Note Search

Example Request - Accord Search

Headless UI Widget

Experience Fragella for yourself, see how it performs in real-world applications, loved by thousands of users

The Most Comprehensive Fragrance Data API. Period.

Granular Note & Accord Data

Advanced Trait & Similarity Search

Performance & Context Ranking

Plus, All The Essentials

Smart Fuzzy Search

Pricing & Purchase Links

CDN-Hosted Assets

74k+ Curated Fragrances

Fast & Reliable

Excellent Documentation

Powered by Fragella

Find the Right Plan for You

Free

Basic

Pro

Pay As You Go

Looking for more?

Common Questions

Partner With Us or Invest in Our Vision

Built on a Modern, Scalable Stack