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

# Ingredients

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

<CodeGroup>
  ```graphql Query theme={null}
  query IngredientById {
    findIngredientById(id: "710", lang: "EN") {
      id
      name
      slug
      family {
        name
        color
      }
      olfactory_description
      history
      effect
      parts_used
      extraction_method
      production
      did_you_know
      image1 {
        urls {
          low
          mid
          high
        }
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findIngredientById": {
        "id": "710",
        "name": "Vanilla",
        "slug": "vanilla-2",
        "family": {
          "name": "AMBERY (ORIENTAL)",
          "color": "#B41F24"
        },
        "olfactory_description": "Sweet and strong , gourmand and bitter, soft, spicy and warm, with some animalic facets.",
        "history": "The Aztecs had an affinity for a number of decadent ingredients, including vanilla, and used the sweet spice to flavor cocoa beverages. The delights of Mexican vanilla were introduced to Europe and its colonies in the 15th century. It would take another three centuries before vanilla made its way to the Indian Ocean, Madagascar, the Reunion Island and the Comoros. ",
        "effect": "Smooth, warm and decadently sweet—the scent of vanilla is easily one of the most recognizable notes in perfumery. It is widely used in ambery accords, as it pairs lovingly with notes of warmth and sensuality. It is soft and delicately spicy, with animalic facets.",
        "parts_used": "Pods",
        "extraction_method": "Solvent extraction",
        "production": "The decadent scent of vanilla derives from the vanilla bean plant (Vanilla planifolia), which is native to Mexico. Today, vanilla is mostly grown in Indonesia, Madagascar, Mexico, the Comoro Islands, Tahiti and China. It is said that the vanilla pods only emit their perfume after having “sweated” for months under woolen cloths. As their aroma wafts and mellows, vanilla crystals begin to form—creating the fragrance we know and love. A process of extraction using volatile solvents produces the concrete, absolute and resinoid. ",
        "did_you_know": "When first introduced to Madagascar, the insect responsible for pollinating the vanilla bean plant was not present. As a result, pollination was done by hand by women known as &quot;matchmakers.&quot;",
        "image1": {
          "urls": {
            "low": "https://api-assets.wikiparfum.com/_resized/zmcyrv2jvpsxxaeijv0z7mlmy64n9hljl0o8g5mtlsdyfw8dtx62be4cymj8-w100-q85.jpg",
            "mid": "https://api-assets.wikiparfum.com/_resized/zmcyrv2jvpsxxaeijv0z7mlmy64n9hljl0o8g5mtlsdyfw8dtx62be4cymj8-w1000-q85.jpg",
            "high": "https://api-assets.wikiparfum.com/_resized/zmcyrv2jvpsxxaeijv0z7mlmy64n9hljl0o8g5mtlsdyfw8dtx62be4cymj8-w2000-q85.jpg"
          }
        }
      }
    }
  }
  ```
</CodeGroup>

### By slug

<CodeGroup>
  ```graphql Query theme={null}
  query IngredientBySlug {
    findIngredientBySlug(slug: "vanilla-2", lang: "EN") {
      id
      name
      olfactory_description
      family {
        name
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findIngredientBySlug": {
        "id": "710",
        "name": "Vanilla",
        "olfactory_description": "Sweet and strong , gourmand and bitter, soft, spicy and warm, with some animalic facets.",
        "family": {
          "name": "AMBERY (ORIENTAL)"
        }
      }
    }
  }
  ```
</CodeGroup>

## List and filter ingredients

Browse the full ingredient catalog with text search, sorting, and pagination.

<CodeGroup>
  ```graphql Query theme={null}
  query BrowseIngredients {
    findIngredients(search: {
      lang: "EN"
      search: "rose"
      page: "0,20"
      order_by: "name asc"
    }) {
      id
      name
      slug
      family {
        name
        color
      }
      image1 {
        urls {
          low
        }
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findIngredients": [
        {
          "id": "757",
          "name": "Champagne Rosé",
          "slug": "champagne-rose-2-6",
          "family": {
            "name": "FRUITY",
            "color": "#F4AF7F"
          },
          "image1": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/smbpsgrvv7ykyzkroqzjjw4xswgfcu3l111oafd0eqmtal9v620up96v3ckx-w100-q85.jpg"
            }
          }
        },
        {
          "id": "1438",
          "name": "Dog Rose",
          "slug": "dog-rose-4",
          "family": {
            "name": "FLORAL",
            "color": "#E2839A"
          },
          "image1": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/3hq9ra6wuwo0ayzetyez4mq75vhrvfgqgcpvjvds91izop2tf4jdvnutryjv-w100-q85.jpg"
            }
          }
        }
      ]
    }
  }
  ```
</CodeGroup>

### Filter by olfactive family

Combine with the `filters` parameter to narrow results to a specific olfactive family.

<CodeGroup>
  ```graphql Query theme={null}
  query FloralIngredients {
    findIngredients(search: {
      lang: "EN"
      page: "0,20"
      filters: {
        family: "floral"
      }
    }) {
      id
      name
      family {
        name
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findIngredients": [
        {
          "id": "14",
          "name": "Almond Blossom",
          "family": {
            "name": "FLORAL"
          }
        },
        {
          "id": "17",
          "name": "Amaranth",
          "family": {
            "name": "FLORAL"
          }
        }
      ]
    }
  }
  ```
</CodeGroup>

## Key ingredient fields

| Field                   | Description                                                                |
| ----------------------- | -------------------------------------------------------------------------- |
| `name`                  | Ingredient name                                                            |
| `family`                | Olfactive family this ingredient belongs to                                |
| `olfactory_description` | How the ingredient smells                                                  |
| `history`               | Historical background                                                      |
| `effect`                | Effect in a fragrance composition                                          |
| `parts_used`            | Part of the plant or source used                                           |
| `extraction_method`     | How the ingredient is extracted                                            |
| `production`            | Production process details                                                 |
| `did_you_know`          | Interesting facts                                                          |
| `ingredientType`        | Type classification                                                        |
| `slug`                  | URL-friendly identifier                                                    |
| `image1` / `image2`     | Resized image URLs                                                         |
| `hero`                  | Whether this is a hero ingredient in a perfume                             |
| `proportion`            | Proportion in a perfume's composition (when returned as part of a perfume) |