Fragrance Library

Enriching your product catalog

A standard product page shows a name, a bottle image, and a price. That’s not enough for fragrance — customers need to understand how a perfume smells before they can buy with confidence. The Fragrance Library transforms your catalog into a definitive guide to understanding each perfume, without needing to smell it.

The business problem

Poorly classified, confusing, and incomplete catalogs are the main reason customers don’t buy perfumes online. They can’t understand the scent, can’t compare products meaningfully, and don’t trust their choice. The result: low conversion, high returns, and lost revenue.

The business impact

Higher conversion — customers who understand what they’re buying are more confident to purchase
Fewer returns — clearer, more visual product information reduces mismatched expectations
Increased customer trust — a uniform, professional fragrance language elevates your catalog
More time on site — rich product content encourages exploration and discovery

What you can build

Olfactive profile cards showing the fragrance’s family, subfamilies, and intensity
Visual ingredient breakdowns with images, descriptions, and hero ingredient highlights
Perfumer profiles linking the creator to their other works
Family context — where this fragrance sits in the olfactive landscape
Quadrification visuals — the olfactive structure of each fragrance as an image
Resized imagery for bottles, ingredients, and families

How Fragrance Library works

Connect — you share your Product Feed with EAN codes
Personalize — you choose which data to integrate (ingredients, families, perfumer, visuals)
Visualize — each perfume is enriched with high-quality ingredient images and olfactive data
Integrate — enriched content appears directly on your product pages
Update — new launches or catalog changes sync automatically

Olfactive profile

Every perfume has a structured olfactive profile: a primary family, an optional secondary family, and intensity. This data powers visual profile cards, radar charts, and classification badges.

query OlfactiveProfile {
  findPerfumeById(id: "424", lang: "EN") {
    name
    family {
      name
      color
    }
    secondaryFamily {
      name
      color
    }
    family_intensity
    secondary_family_intensity
    intensity
    gender
    classification
    quadrification_url {
      width100
      width500
      width1000
    }
  }
}

{
  "data": {
    "findPerfumeById": {
      "name": "GOOD GIRL",
      "family": {
        "name": "AMBERY (ORIENTAL)",
        "color": "#B41F24"
      },
      "secondaryFamily": {
        "name": "AMBERY (ORIENTAL)",
        "color": "#B41F24"
      },
      "family_intensity": 9,
      "secondary_family_intensity": 9,
      "intensity": 9.15,
      "gender": "F",
      "classification": "PRESTIGE",
      "quadrification_url": {
        "width100": "https://api-dev.wikiparfum.com/quadrification?slug=good-girl&lang=EN&size=100",
        "width500": "https://api-dev.wikiparfum.com/quadrification?slug=good-girl&lang=EN&size=500",
        "width1000": "https://api-dev.wikiparfum.com/quadrification?slug=good-girl&lang=EN&size=1000"
      }
    }
  }
}

The quadrification_url provides the Quadrification — a proprietary visual representation of the olfactive profile. See Olfactive Classification for more on classification and the Quadrification.

Ingredient breakdown

Each perfume includes its ingredient list, with proportions and hero flags. Use this to build ingredient carousels, expandable ingredient panels, or educational overlays — letting users visually understand the scent of each perfume by identifying its dominant notes.

query PerfumeIngredients {
  findPerfumeById(id: "424", lang: "EN") {
    id
    name
    ingredients {
      id
      name
      proportion
      hero
      family {
        name
        color
      }
      image1 {
        urls {
          low
          mid
        }
      }
    }
  }
}

{
  "data": {
    "findPerfumeById": {
      "id": "424",
      "name": "GOOD GIRL",
      "ingredients": [
        {
          "id": "13",
          "name": "Almond",
          "proportion": null,
          "hero": 0,
          "family": {
            "name": "GOURMAND",
            "color": "#E08A4E"
          },
          "image1": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/gxm5zq2i9asy84b95xz9xhgzlgdlf3e12xcbpfjnjiicvl1a007m94ksudr1-w100-q85.jpg",
              "mid": "https://api-assets.wikiparfum.com/_resized/gxm5zq2i9asy84b95xz9xhgzlgdlf3e12xcbpfjnjiicvl1a007m94ksudr1-w1000-q85.jpg"
            }
          }
        },
        {
          "id": "115",
          "name": "Cocoa",
          "proportion": null,
          "hero": 0,
          "family": {
            "name": "GOURMAND",
            "color": "#E08A4E"
          },
          "image1": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/owru9yx7h3ghfd0b4kjui37y8gl8f1azupskb9lvru856axmklw0ucd1kh20-w100-q85.jpg",
              "mid": "https://api-assets.wikiparfum.com/_resized/owru9yx7h3ghfd0b4kjui37y8gl8f1azupskb9lvru856axmklw0ucd1kh20-w1000-q85.jpg"
            }
          }
        }
      ]
    }
  }
}

Hero ingredients (hero: 1) are the defining notes of the fragrance — highlight these prominently. Proportion values indicate relative weight in the composition.

Perfumer profile

Surface the creator behind the fragrance. Many users develop loyalty to specific perfumers once they discover the connection between their favorite fragrances.

query PerfumerInfo {
  findPerfumeById(id: "424", lang: "EN") {
    name
    perfumers {
      id
      name
      slug
    }
  }
}

{
  "data": {
    "findPerfumeById": {
      "name": "GOOD GIRL",
      "perfumers": [
        {
          "id": "106",
          "name": "Louise Turner",
          "slug": "louise-turner"
        }
      ]
    }
  }
}

Fetch the full perfumer profile for a dedicated section or link-through page:

query PerfumistDetail {
  findPerfumistBySlug(slug: "francis-kurkdjian", lang: "EN") {
    id
    name
    bio
    house
    image1 {
      urls {
        low
        mid
        high
      }
    }
    perfumes
  }
}

{
  "data": {
    "findPerfumistBySlug": {
      "id": "69",
      "name": "Francis Kurkdjian",
      "bio": "The Paris Opera and its corps de ballet. Haute Couture and its designers. The world of perfumes and its artistic imagination. Three spheres defined by discipline and rigour, culture and determination, which inspire this slim-featured man on a daily basis. Francis Kurkdjian has quickly made a name for himself among the best-known perfumers, arousing admiration and envy, sometimes both at the same time. <br> Francis owes his talent to his commitment, no doubt helped by his passion for art and for this world of fragrances that he discovered as a teenager. But above all to that desire to never let down those who trust him: a winning attitude that enabled him to create world-renowned fragrances very soon after graduating from the ISIPCA school of perfumery and cosmetics, to design custom fragrances, to give an olfactory touch to art installations all over the world and, in 2009, to create his eponymous fragrance maison, a stake he sold to the LVMH group in 2017. In addition, this perfumer-creator has worked at Takasago since 2005, creating numerous successful fragrances. <br> He also passes on his knowledge to the company's young perfumers, as he is passionate about education.<br>\nIn October 2021, he was appointed head of Christian Dior's Perfume Creation Department.\n",
      "house": "Dior",
      "image1": {
        "urls": {
          "low": "https://api-assets.wikiparfum.com/_resized/bxrinj1ri6tdco8sjg2mocgqn6edjgirct20jrr6vkt3na80yu702l462yqk-w100-q85.jpg",
          "mid": "https://api-assets.wikiparfum.com/_resized/bxrinj1ri6tdco8sjg2mocgqn6edjgirct20jrr6vkt3na80yu702l462yqk-w1000-q85.jpg",
          "high": "https://api-assets.wikiparfum.com/_resized/bxrinj1ri6tdco8sjg2mocgqn6edjgirct20jrr6vkt3na80yu702l462yqk-w2000-q85.jpg"
        }
      },
      "perfumes": [
        "301",
        "303"
      ]
    }
  }
}

Visual assets

WikiParfum provides resized imagery for perfumes, ingredients, and families in multiple sizes. Use the image field (or image1, image2 for ingredients) to get responsive assets without managing image processing.

query PerfumeVisuals {
  findPerfumeById(id: "424", lang: "EN") {
    name
    image {
      urls {
        low
        mid
        high
      }
    }
    isDark
  }
}

{
  "data": {
    "findPerfumeById": {
      "name": "GOOD GIRL",
      "image": {
        "urls": {
          "low": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w100-q85.jpg",
          "mid": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w250-q85.jpg",
          "high": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w500-q85.jpg"
        }
      },
      "isDark": false
    }
  }
}

The isDark flag indicates whether the bottle image has a dark background, useful for adapting UI contrast.

EAN-based enrichment

For retailers integrating with existing catalog systems, perfumes can be looked up directly by EAN barcode — no ID mapping required. See Catalog Integration for the full catalog setup flow.

query EnrichByEAN {
  findPerfumeByEAN(ean: "8411061994351", lang: "EN") {
    id
    name
    description
    brand {
      name
    }
    family {
      name
      color
    }
    ingredients {
      name
      hero
    }
    image {
      urls {
        low
        mid
        high
      }
    }
    gender
    quadrification_url {
      width100
      width500
    }
    perfumers {
      name
    }
  }
}

{
  "data": {
    "findPerfumeByEAN": {
      "id": "424",
      "name": "GOOD GIRL",
      "description": "Good Girl is a fragrance as powerful as it is sensual. An audacious blend of dark and light elements. For the woman who knows when it's good to be bad.",
      "brand": {
        "name": "Carolina Herrera"
      },
      "family": {
        "name": "AMBERY (ORIENTAL)",
        "color": "#B41F24"
      },
      "ingredients": [
        {
          "name": "Almond",
          "hero": 0
        },
        {
          "name": "Cocoa",
          "hero": 0
        }
      ],
      "image": {
        "urls": {
          "low": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w100-q85.jpg",
          "mid": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w250-q85.jpg",
          "high": "https://api-assets.wikiparfum.com/_resized/1trb5qms3qhq6u8ja6jc2pwj13zqn6q1u3lftxcoq2qq5th2obdx8be8kopg-w500-q85.jpg"
        }
      },
      "gender": "F",
      "quadrification_url": {
        "width100": "https://api-dev.wikiparfum.com/quadrification?slug=good-girl&lang=EN&size=100",
        "width500": "https://api-dev.wikiparfum.com/quadrification?slug=good-girl&lang=EN&size=500"
      },
      "perfumers": [
        {
          "name": "Louise Turner"
        }
      ]
    }
  }
}

Multi-language support

All enrichment content — ingredient names, descriptions, family names, perfumer bios — is available in multiple languages. Pass the appropriate lang parameter to get content localized for your market.

query EnrichInFrench {
  findPerfumeByEAN(ean: "8411061994351", lang: "FR") {
    id
    name
    description
    family {
      name
    }
    ingredients {
      name
    }
  }
}

{
  "data": {
    "findPerfumeByEAN": {
      "id": "424",
      "name": "GOOD GIRL",
      "description": "Les qualités douces et séduisantes du jasmin apportent une féminité pétillante à Good Girl. Le cacao riche et parfumé et la fève tonka enivrante expriment le côté mystérieux de Good Girl, tandis que l'amande et le café apportent des notes de vitalité audacieuse.\nGood Girl est une ode à la dualité de la femme, à l'attrait de son bon côté et de son côté sombre.",
      "family": {
        "name": "AMBRÉ (ORIENTAL)"
      },
      "ingredients": [
        {
          "name": "Amande"
        },
        {
          "name": "Cacao"
        }
      ]
    }
  }
}

This enables the same enrichment experience across different markets and storefronts without managing translations.

Getting Started

Guides

API Reference

Fragrance Library

Enriching your product catalog

The business problem

The business impact

What you can build

How Fragrance Library works

Olfactive profile

Ingredient breakdown

Perfumer profile

Visual assets

EAN-based enrichment

Multi-language support

​Enriching your product catalog

​The business problem

​The business impact

​What you can build

​How Fragrance Library works

​Olfactive profile

​Ingredient breakdown

​Perfumer profile

​Visual assets

​EAN-based enrichment

​Multi-language support

Enriching your product catalog

The business problem

The business impact

What you can build

How Fragrance Library works

Olfactive profile

Ingredient breakdown

Perfumer profile

Visual assets

EAN-based enrichment

Multi-language support