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

# Perfumists

## Perfumer data

WikiParfum catalogs the world's perfumers (perfumists) with biographical information, associated fragrance houses, and links to their creations. Use perfumer data to build creator profiles, attribute fragrances to their makers, and enable perfumer-driven discovery.

## Retrieve a single perfumer

### By ID

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumistById {
    findPerfumistById(id: "69", lang: "EN") {
      id
      name
      slug
      bio
      house
      country
      gender
      teaser
      perfumes
      image1 { urls { low mid high } }
      image2 { urls { low mid high } }
      image3 { urls { low mid high } }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findPerfumistById": {
        "id": "69",
        "name": "Francis Kurkdjian",
        "slug": "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",
        "country": "",
        "gender": "U",
        "teaser": "Francis owes his talent to his commitment, no doubt helped by his passion for art and for this world of fragrance that he discovered as an adolescent.  ",
        "perfumes": [
          "301",
          "303"
        ],
        "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"
          }
        },
        "image2": null,
        "image3": null
      }
    }
  }
  ```
</CodeGroup>

### By slug

<CodeGroup>
  ```graphql Query theme={null}
  query PerfumistBySlug {
    findPerfumistBySlug(slug: "francis-kurkdjian", lang: "EN") {
      id
      name
      slug
      bio
      house
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findPerfumistBySlug": {
        "id": "69",
        "name": "Francis Kurkdjian",
        "slug": "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"
      }
    }
  }
  ```
</CodeGroup>

## List and search perfumers

Browse the perfumer catalog with text search and pagination.

<CodeGroup>
  ```graphql Query theme={null}
  query BrowsePerfumists {
    findPerfumists(search: {
      lang: "EN"
      search: "francis"
      page: "0,10"
    }) {
      id
      name
      slug
      house
      image1 { urls { low } }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findPerfumists": [
        {
          "id": "39",
          "name": "Francis Deléamont",
          "slug": "francis-deleamont",
          "house": null,
          "image1": null
        },
        {
          "id": "69",
          "name": "Francis Kurkdjian",
          "slug": "francis-kurkdjian",
          "house": "Dior",
          "image1": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/bxrinj1ri6tdco8sjg2mocgqn6edjgirct20jrr6vkt3na80yu702l462yqk-w100-q85.jpg"
            }
          }
        }
      ]
    }
  }
  ```
</CodeGroup>

## Key perfumer fields

| Field                          | Description                                      |
| ------------------------------ | ------------------------------------------------ |
| `id`                           | Unique perfumer identifier                       |
| `name`                         | Perfumer name                                    |
| `slug`                         | URL-friendly identifier                          |
| `bio`                          | Biographical text                                |
| `house`                        | Fragrance house affiliation                      |
| `country`                      | Country of origin                                |
| `gender`                       | Perfumer gender                                  |
| `perfumes`                     | Array of perfume IDs attributed to this perfumer |
| `teaser`                       | Short summary text                               |
| `image1` / `image2` / `image3` | Resized image URLs                               |
