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

# Brands

## Brand data

WikiParfum maintains a curated catalog of fragrance brands with metadata including descriptions, logos, sub-brands, and catalog size. Use brand data to power brand landing pages, directory browsing, and filtered discovery experiences.

## Retrieve a single brand

### By ID

<CodeGroup>
  ```graphql Query theme={null}
  query BrandById {
    findBrandById(id: "42", lang: "EN") {
      id
      name
      slug
      description
      brandImage {
        urls {
          low
          mid
          high
        }
      }
      segment
      year
      origin
      founder
      subBrands {
        id
        name
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findBrandById": {
        "id": "42",
        "name": "Hugo Boss",
        "slug": "hugo-boss",
        "description": "Founded in 1924 by Hugo Ferdinand Boss in Germany as a fashion company, Hugo Boss experienced its golden age in the 1970s, when it specialised in the design of luxury suits for men and expanded internationally.\n\nIts foray into the world of perfume began in 1985 with the launch of its first men's fragrance, Boss Number One, a fougère scent that connected with the men of the time. Since then, the brand has continued to expand its collection of perfumes aimed at both male and female consumers.\n\nBoss Bottled (1998) is its most emblematic perfume, a composition that represents the modern man, with a balanced blend of fresh and warm ingredients, and which has been successfully versioned over the years.",
        "brandImage": {
          "urls": {
            "low": "https://api-assets.wikiparfum.com/_resized/06j8usxh45bnqyzus9daj9c8ao0r4v2fcwgqlnw34ufcnf1ohbwv6kr10ll2-w100-q85.jpg",
            "mid": "https://api-assets.wikiparfum.com/_resized/06j8usxh45bnqyzus9daj9c8ao0r4v2fcwgqlnw34ufcnf1ohbwv6kr10ll2-w250-q85.jpg",
            "high": "https://api-assets.wikiparfum.com/_resized/06j8usxh45bnqyzus9daj9c8ao0r4v2fcwgqlnw34ufcnf1ohbwv6kr10ll2-w500-q85.jpg"
          }
        },
        "segment": "PRESTIGE",
        "year": "1924",
        "origin": "DE",
        "founder": "Hugo Ferdinand Boss",
        "subBrands": [
          {
            "id": "144",
            "name": "Boss"
          },
          {
            "id": "145",
            "name": "Boss Collection"
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

## List and filter brands

Browse brands with text search, alphabetical filtering, sorting, and pagination.

<CodeGroup>
  ```graphql Query theme={null}
  query BrowseBrands {
    findBrands(search: {
      lang: "EN"
      search: "chanel"
      page: "0,20"
      order_by: "name asc"
    }) {
      id
      name
      slug
      segment
      totalFragrances
      brandImage {
        urls {
          low
        }
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findBrands": [
        {
          "id": "566",
          "name": "Chanel",
          "slug": "chanel",
          "segment": "PRESTIGE",
          "totalFragrances": 109,
          "brandImage": {
            "urls": {
              "low": "https://api-assets.wikiparfum.com/_resized/19omj4whel12a1989af9hptp0ck5e74h1ybgjq7q82im58p04goi6syeyp3u-w100-q85.jpg"
            }
          }
        }
      ]
    }
  }
  ```
</CodeGroup>

### Filter by letter

Build an alphabetical brand directory.

<CodeGroup>
  ```graphql Query theme={null}
  query BrandsByLetter {
    findBrands(search: {
      lang: "EN"
      letter: "C"
      page: "0,50"
      order_by: "name asc"
    }) {
      id
      name
      slug
      totalFragrances
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findBrands": [
        {
          "id": "20",
          "name": "Calvin Klein",
          "slug": "calvin-klein",
          "totalFragrances": 597
        },
        {
          "id": "75",
          "name": "Carolina Herrera",
          "slug": "carolina-herrera",
          "totalFragrances": 597
        }
      ]
    }
  }
  ```
</CodeGroup>

### Filter by market segment

<CodeGroup>
  ```graphql Query theme={null}
  query PrestigeBrands {
    findBrands(search: {
      lang: "EN"
      page: "0,20"
      filters: {
        classification: "prestige"
      }
    }) {
      id
      name
      segment
      totalFragrances
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "findBrands": [
        {
          "id": "2",
          "name": "Guerlain",
          "segment": "PRESTIGE",
          "totalFragrances": 2386
        },
        {
          "id": "6",
          "name": "Marc Jacobs",
          "segment": "PRESTIGE",
          "totalFragrances": 2386
        }
      ]
    }
  }
  ```
</CodeGroup>

## Key brand fields

| Field             | Description                                                        |
| ----------------- | ------------------------------------------------------------------ |
| `name`            | Brand name                                                         |
| `slug`            | URL-friendly identifier                                            |
| `description`     | Brand description                                                  |
| `brandImage`      | Brand logo/image with resized URLs                                 |
| `segment`         | Market segment                                                     |
| `totalFragrances` | Number of fragrances in the catalog                                |
| `year`            | Year the brand was founded                                         |
| `origin`          | Country of origin                                                  |
| `founder`         | Brand founder                                                      |
| `subBrands`       | Sub-brand lines (e.g., "Armani Priv\u00e9" under "Giorgio Armani") |
| `region`          | Geographic region                                                  |