> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scentxp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

1. **Connect** — you share your [Product Feed](/catalog-integration/product-feed) with EAN codes
2. **Personalize** — you choose which data to integrate (ingredients, families, perfumer, visuals)
3. **Visualize** — each perfume is enriched with high-quality ingredient images and olfactive data
4. **Integrate** — enriched content appears directly on your product pages
5. **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.

<CodeGroup>
  ```graphql Query theme={null}
  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
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "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"
        }
      }
    }
  }
  ```
</CodeGroup>

The `quadrification_url` provides the Quadrification — a proprietary visual representation of the olfactive profile. See [Olfactive Classification](/wikiparfum-api/guides/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.

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumeIngredients {
    findPerfumeById(id: "424", lang: "EN") {
      id
      name
      ingredients {
        id
        name
        proportion
        hero
        family {
          name
          color
        }
        image1 {
          urls {
            low
            mid
          }
        }
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "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"
              }
            }
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

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.

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumerInfo {
    findPerfumeById(id: "424", lang: "EN") {
      name
      perfumers {
        id
        name
        slug
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findPerfumeById": {
        "name": "GOOD GIRL",
        "perfumers": [
          {
            "id": "106",
            "name": "Louise Turner",
            "slug": "louise-turner"
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

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

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumistDetail {
    findPerfumistBySlug(slug: "francis-kurkdjian", lang: "EN") {
      id
      name
      bio
      house
      image1 {
        urls {
          low
          mid
          high
        }
      }
      perfumes
    }
  }
  ```

  ```json Response theme={null}
  {
    "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"
        ]
      }
    }
  }
  ```
</CodeGroup>

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

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumeVisuals {
    findPerfumeById(id: "424", lang: "EN") {
      name
      image {
        urls {
          low
          mid
          high
        }
      }
      isDark
    }
  }
  ```

  ```json Response theme={null}
  {
    "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
      }
    }
  }
  ```
</CodeGroup>

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](/catalog-integration/product-feed) for the full catalog setup flow.

<CodeGroup>
  ```graphql Query theme={null}
  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
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "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"
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

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

<CodeGroup>
  ```graphql Query theme={null}
  query EnrichInFrench {
    findPerfumeByEAN(ean: "8411061994351", lang: "FR") {
      id
      name
      description
      family {
        name
      }
      ingredients {
        name
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "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"
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

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