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

# Families

## Olfactive families

Olfactive families are the top-level taxonomy of the fragrance world — categories like Floral, Woody, Ambery, and Citrus that group perfumes by their dominant character. WikiParfum provides a structured family hierarchy that powers navigation, filtering, and visual categorization across the platform.

## Retrieve a single family

### By ID

<CodeGroup>
  ```graphql Query theme={null}
  query FamilyById {
    findFamilyById(id: "5", lang: "EN") {
      id
      name
      slug
      color
      description
      isPrimary
      image {
        urls {
          low
          mid
          high
        }
      }
      combinations {
        name
        color
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findFamilyById": {
        "id": "5",
        "name": "AROMATIC FOUGERE",
        "slug": "aromatic-fougere",
        "color": "#01918D",
        "description": "The Aromatic family, also called Fougère in perfume jargon because of the fragrance Fougère Royale, created in 1884, which was the first evoking this natural, undergrowth smell.\nInitially composed of lavender, oakmoss, coumarin and bergamot, this family evolved using a lot of different aromatic plant such as basil, sage, rosemary, thyme, etc.\nAs this kind of fragrance was used a lot in the 80’s for masculine barber products, it is associated with the **masculine world**, transmitting an energetic and clean sexiness.",
        "isPrimary": true,
        "image": {
          "urls": {
            "low": "https://api-assets.wikiparfum.com/_resized/623d401ea7f016dc0d0eb105c93f5efe02f8ce30-w100-q85.jpg",
            "mid": "https://api-assets.wikiparfum.com/_resized/623d401ea7f016dc0d0eb105c93f5efe02f8ce30-w500-q85.jpg",
            "high": "https://api-assets.wikiparfum.com/_resized/623d401ea7f016dc0d0eb105c93f5efe02f8ce30-w1000-q85.jpg"
          }
        },
        "combinations": [
          {
            "name": "AROMATIC FOUGERE",
            "color": "#01918D"
          },
          {
            "name": "CITRUS",
            "color": "#FFD33F"
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

### By slug

<CodeGroup>
  ```graphql Query theme={null}
  query FamilyBySlug {
    findFamilyBySlug(slug: "woody", lang: "EN") {
      id
      name
      description
      color
      isPrimary
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findFamilyBySlug": {
        "id": "10",
        "name": "WOODY",
        "description": "The woody ingredients are rich and multifaceted, creamy, strong, elegant, warm or dry, sensual or reassuring. The research of synthetic molecules has increased the perfumer’s palette with interesting woody notes, completing the natural one, and bringing new powerful effects.",
        "color": "#92623B",
        "isPrimary": true
      }
    }
  }
  ```
</CodeGroup>

## List families

Browse all olfactive families. Use `isPrimary` to filter between main families and subfamilies.

<CodeGroup>
  ```graphql Query theme={null}
  query PrimaryFamilies {
    findFamilies(search: {
      lang: "EN"
      isPrimary: true
      order_by: "position asc"
    }) {
      id
      name
      slug
      color
      description
      image {
        urls {
          low
          mid
        }
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findFamilies": [
        {
          "id": "1",
          "name": "CITRUS",
          "slug": "citrus",
          "color": "#FFD33F",
          "description": "The citrus ingredients, also named hesperidian, cover natural essential oils obtained by expression of the rind of citrus fruits, but also plants or reconstitution accords that offers a sparkling freshness, energetic and tangy.",
          "image": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/ef43511fad5caeef8f15b58fbbfc9675f7568109-w100-q85.jpg",
              "mid": "https://api-assets.wikiparfum.com/_resized/ef43511fad5caeef8f15b58fbbfc9675f7568109-w500-q85.jpg"
            }
          }
        },
        {
          "id": "5",
          "name": "AROMATIC FOUGERE",
          "slug": "aromatic-fougere",
          "color": "#01918D",
          "description": "The Aromatic family, also called Fougère in perfume jargon because of the fragrance Fougère Royale, created in 1884, which was the first evoking this natural, undergrowth smell.\nInitially composed of lavender, oakmoss, coumarin and bergamot, this family evolved using a lot of different aromatic plant such as basil, sage, rosemary, thyme, etc.\nAs this kind of fragrance was used a lot in the 80’s for masculine barber products, it is associated with the **masculine world**, transmitting an energetic and clean sexiness.",
          "image": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/623d401ea7f016dc0d0eb105c93f5efe02f8ce30-w100-q85.jpg",
              "mid": "https://api-assets.wikiparfum.com/_resized/623d401ea7f016dc0d0eb105c93f5efe02f8ce30-w500-q85.jpg"
            }
          }
        }
      ]
    }
  }
  ```
</CodeGroup>

### All families including subfamilies

<CodeGroup>
  ```graphql Query theme={null}
  query AllFamilies {
    findFamilies(search: {
      lang: "EN"
    }) {
      id
      name
      slug
      color
      isPrimary
      level
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findFamilies": [
        {
          "id": "1",
          "name": "CITRUS",
          "slug": "citrus",
          "color": "#FFD33F",
          "isPrimary": true,
          "level": 1
        },
        {
          "id": "2",
          "name": "GREEN",
          "slug": "green",
          "color": "#51A84B",
          "isPrimary": false,
          "level": 2
        }
      ]
    }
  }
  ```
</CodeGroup>

## Key family fields

| Field          | Description                                     |
| -------------- | ----------------------------------------------- |
| `name`         | Family name (e.g., "Floral", "Woody")           |
| `slug`         | URL-friendly identifier                         |
| `color`        | Brand color associated with this family (hex)   |
| `description`  | Descriptive text about the family               |
| `isPrimary`    | Whether this is a primary family or a subfamily |
| `level`        | Hierarchy level in the family tree              |
| `position`     | Display order                                   |
| `image`        | Resized image URLs                              |
| `combinations` | Common family pairings (name, color)            |
| `intensity`    | Average intensity for perfumes in this family   |