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.

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

Don't just read about it. Watch a real-time demonstration of our API's capabilities in our interactive playground and see how quickly you can get the data you need.

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",
    "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.

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

Built on a Modern, Scalable Stack

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