Skip to main content

​
Perfume data

Perfumes are the central entity in WikiParfum. Each perfume record includes rich metadata — brand, olfactive family, ingredients, perfumers, concepts, imagery, and more — enabling product pages, comparison tools, and enriched catalog experiences.

​
Retrieve a single perfume

Fetch a perfume by its unique ID, URL-friendly slug, or EAN barcode.

​
By ID

query PerfumeById {
  findPerfumeById(id: "1234", lang: "EN") {
    id
    name
    description
    brand {
      name
    }
    family {
      name
      color
    }
    secondaryFamily {
      name
    }
    gender
    year
    ingredients {
      id
      name
      proportion
      hero
    }
    concepts {
      name
    }
    image {
      small
      medium
      large
    }
    slug
  }
}

​
By slug

Useful for SEO-friendly URLs and deep linking. 
query PerfumeBySlug {
  findPerfumeBySlug(slug: "dior-sauvage", lang: "EN") {
    id
    name
    brand {
      name
    }
    family {
      name
    }
  }
}

​
By EAN

Look up a perfume using its barcode — ideal for scan-to-discover experiences. 
query PerfumeByEAN {
  findPerfumeByEAN(ean: "3348901250511", lang: "EN") {
    id
    name
    brand {
      name
    }
    ean
  }
}
You can also look up multiple EANs at once: 
query PerfumesByEANS {
  findPerfumesByEANS(
    eans: ["3348901250511", "3346470135772"]
    lang: "EN"
  ) {
    id
    name
    ean
  }
}

​
List and filter perfumes

Retrieve perfumes with full-text search, filters, sorting, and pagination. 
query FilteredPerfumes {
  findPerfumes(search: {
    lang: "EN"
    search: "sauvage"
    page: "0,20"
    order_by: "name asc"
    filters: {
      gender: "M"
      classification: "prestige"
    }
  }) {
    id
    name
    brand {
      name
    }
    family {
      name
    }
    gender
    year
  }
}

​
Filter by brand

query PerfumesByBrand {
  findPerfumes(search: {
    lang: "EN"
    brand: "42"
    page: "0,20"
  }) {
    id
    name
    year
  }
}

​
Filter by perfumist

query PerfumesByPerfumist {
  findPerfumes(search: {
    lang: "EN"
    perfumistSlug: "francis-kurkdjian"
    page: "0,20"
  }) {
    id
    name
    brand {
      name
    }
  }
}

​
Key perfume fields

FieldDescription
namePerfume name
brandBrand information
family / secondaryFamily / tertiaryFamilyOlfactive family classification (up to three levels)
genderTarget gender: "F", "M", or "U" (unisex)
year / monthRelease date
ingredientsList of ingredients with proportion and hero flag
conceptsDescriptive tags (e.g., “fresh”, “woody”)
classificationMarket segment: "prestige" or "mass"
slugURL-friendly identifier
ean / eansBarcode(s)
imageResized image URLs (small, medium, large)
perfumersPerfumers who created the fragrance
intensityOlfactive intensity score
discontinuedWhether the perfume is discontinued