The Ultimate Fragrance Data API

Designed to give you exactly what matters fast, Structured JSON for 13k+ fragrances, with full note breakdowns with occurence and description, accord percentages, longevity, sillage, season, occasion, pricing, brand info, images, andPurchase Link.

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

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

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",
    "Image Fallbacks": [
    "https://...../eau-sauvage.jpg"
                    ],
   "Purchase URL": "https:....",
    "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",
    "Image Fallbacks": [
    "https://...../eau-sauvage.jpg"
                    ],
   "Purchase URL": "https:....",

    "Gender": "women",
    "Price": "114.99",
    "Longevity": "51.2%",
    "Sillage": "43.75%",
    "Main Accords": [
      "floral", "fruity", "citrus", "amber", "woody"
    ],
    "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
    }
  ]
}

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'

// Sample Response (200 OK)
[
    {
        "Name": "Chirstian Dior Eau Sauvage Edt",
        "Brand": "Dior",
        "Image URL": "https://.../chirstian-dior-eau-sauvage-edt.jpg",
        "Gender": "Men",
        "Price": "69.00",
        "Longevity": "55.6%",
        "Sillage": "49.25%",
        "Main Accords": ["aromatic", "citrus", "fresh spicy", ...],
        "Notes": {
            "Top": [{"name":"Lemon", "imageUrl":"..."}, ...],
            "Middle": [{"name":"Jasmine", "imageUrl":"..."}, ...],
            "Base": [{"name":"Oakmoss", "imageUrl":"..."}, ...]
        }
    },
    {
        "Name": "Christian Dior Dior Sauvage Edp",
        "Brand": "Dior",
        "Image URL": "https://.../christian-dior-dior-sauvage-edp.jpg",
        "Gender": "Men",
        "Price": "85.00",
        "Longevity": "75.2%",
        "Sillage": "66.0%",
        "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'

// 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://d2k6fvhyk5xgx.cloudfront.net/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://d2k6fvhyk5xgx.cloudfront.net/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://d2k6fvhyk5xgx.cloudfront.net/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'

// 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."
    }
]

Access the Playground

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, and base notes come with descriptions and occurrence details for each individual note, along with icons that you can drop straight into any UI.

Accord Percentages, Description and Occurence

Know exactly how dominant each accord is, down to the percent, with descriptions and occurrence details for every single accord

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, Purchase Link

Price points, brand info, gender tags, and Purchase Link 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.

Free

For hobbyists and exploration.

$0/month

20 requests/month

Get Started

Basic

For small projects.

$12/month

2,500 requests/month

Get Started

Pro

For production apps.

$49/month

7,500 requests/month
Overages Enabled
Unused Requests Carry Over (cap 3000)

Get Started

Enterprise

For custom needs.

Custom

Custom Limits
Dedicated Support

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.