Skip to main content

​
Fragrance discovery

Most users arrive at a fragrance platform without a specific product in mind. WikiParfum turns this open-ended exploration into a structured, guided experience — helping users move from vague preferences to concrete fragrance options through multiple complementary entry points.

​
What you can build

  • Search-as-you-type interfaces across perfumes, brands, and ingredients
  • Ingredient-driven browsing — “show me perfumes with oud”
  • Olfactive family navigation — visual maps and family-based filtering
  • Guided questionnaires that progressively narrow down fragrance matches
  • Concept exploration — let users browse by evocative terms like “fresh”, “sensual”, or “woody”

​
Search across the catalog

The unified search query lets users type freely and get results across perfumes, ingredients, brands, families, and perfumists — ideal for building an omnibox or search bar. 
query Search {
  search(q: "dior", lang: "EN", types: [perfumes], limit: 10) {
    totals {
      perfumes
    }
    results {
      perfumes {
        id
        score
      }
    }
  }
}
See Search for the full query reference, including multi-type search, catalog scoping, and multi-language support.

​
Browse by ingredient

One of the most engaging discovery paths. Users who enjoy a particular note — oud, vanilla, bergamot — can explore all perfumes built around it. 
query PerfumesByIngredient {
  findPerfumeByIngredient(
    ingredientSlug: "vanilla"
    lang: "EN"
    page: "0,10"
  ) {
    id
    name
    brand {
      name
    }
    family {
      name
      color
    }
    ingredients {
      name
      proportion
      hero
    }
  }
}
You can also require multiple ingredients simultaneously — for example, finding perfumes that feature both rose and oud: 
query PerfumesWithMultipleIngredients {
  findPerfumeByIngredient(
    ingredient: "42,87"
    lang: "EN"
    and: true
    page: "0,10"
  ) {
    id
    name
  }
}
Families — Floral, Woody, Oriental, Fresh, and their subfamilies — are the top-level taxonomy of fragrance. They provide a natural browsing structure for users who think in terms of scent character rather than specific products. 
query PrimaryFamilies {
  findFamilies(search: { lang: "EN", isPrimary: true }) {
    id
    name
    slug
    color
    description
    image {
      small
      medium
    }
  }
}
Each family includes a color and imagery, making it easy to build visual navigation grids. See Families for the full entity reference.

​
Explore concepts

Concepts are descriptive tags that bridge everyday language and olfactive structure — terms like “romantic”, “energetic”, or “elegant” that users intuitively understand, even without fragrance expertise. 
query PerfumeWithConcepts {
  findPerfumeById(id: "1234", lang: "EN") {
    id
    name
    concepts {
      id
      name
    }
  }
}

​
Guided discovery

The discoverPerfumes query powers step-by-step questionnaire flows. Users answer a series of preference questions and receive a curated set of matching perfumes — no fragrance knowledge required. 
query GuidedDiscovery {
  discoverPerfumes(
    questions: [
      { id: "gender", answer: "F" }
      { id: "family", answer: "floral" }
    ]
    lang: "EN"
  ) {
    id
    name
    brand {
      name
    }
    family {
      name
    }
  }
}
This is particularly effective for onboarding new users or building interactive gift-finder experiences.