Skip to main content

​
Ingredient data

Ingredients are the building blocks of every fragrance. WikiParfum provides detailed ingredient records including olfactive descriptions, production methods, origin, and imagery — enabling educational content, ingredient-driven browsing, and enriched product pages.

​
Retrieve a single ingredient

​
By ID

query IngredientById {
  findIngredientById(id: "42", lang: "EN") {
    id
    name
    slug
    family {
      name
      color
    }
    olfactory_description
    history
    effect
    parts_used
    extraction_method
    production
    did_you_know
    image1 {
      small
      medium
      large
    }
  }
}

​
By slug

query IngredientBySlug {
  findIngredientBySlug(slug: "vanilla", lang: "EN") {
    id
    name
    olfactory_description
    family {
      name
    }
  }
}

​
List and filter ingredients

Browse the full ingredient catalog with text search, sorting, and pagination. 
query BrowseIngredients {
  findIngredients(search: {
    lang: "EN"
    search: "rose"
    page: "0,20"
    order_by: "name asc"
  }) {
    id
    name
    slug
    family {
      name
      color
    }
    olfactory_description
    image1 {
      small
    }
  }
}

​
Filter by olfactive family

Combine with the filters parameter to narrow results to a specific olfactive family. 
query FloralIngredients {
  findIngredients(search: {
    lang: "EN"
    page: "0,20"
    filters: {
      family: "floral"
    }
  }) {
    id
    name
    family {
      name
    }
  }
}

​
Key ingredient fields

FieldDescription
nameIngredient name
familyOlfactive family this ingredient belongs to
olfactory_descriptionHow the ingredient smells
historyHistorical background
effectEffect in a fragrance composition
parts_usedPart of the plant or source used
extraction_methodHow the ingredient is extracted
productionProduction process details
did_you_knowInteresting facts
ingredientTypeType classification
slugURL-friendly identifier
image1 / image2Resized image URLs
heroWhether this is a hero ingredient in a perfume
proportionProportion in a perfume’s composition (when returned as part of a perfume)