Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heychocolate.com/llms.txt

Use this file to discover all available pages before exploring further.

The Search module provides powerful full-text and faceted search across all sustainability data in the platform. 
query {
  search(query: "bio-based window frame") {
    totalCount
    results {
      ... on Product {
        id
        name
        sectorTag
        impactScore { co2Equivalent mkiScore }
      }
      ... on Supplier {
        id
        name
        country
      }
    }
  }
}
Narrow results using sector, score ranges, certifications, and more: 
query {
  searchProducts(input: {
    query: "window frame"
    filters: {
      sectorTag: HIGHTECH_MANUFACTURING
      co2Range: { min: 0, max: 20 }
      mkiRange: { min: 0, max: 1.5 }
      certifications: ["ISO14001"]
      countries: ["NL", "DE", "BE"]
    }
    sort: { field: CO2_EQUIVALENT, direction: ASC }
    first: 20
  }) {
    totalCount
    edges {
      node {
        id
        name
        sectorTag
        impactScore { co2Equivalent mkiScore }
        certifications
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    facets {
      sectorTag { value count }
      certifications { value count }
      countries { value count }
    }
  }
}

​
Available filters

FilterTypeDescription
sectorTagEnumAGRI, FOOD, HIGHTECH_MANUFACTURING, GREEN_CHEMISTRY, TRADE
co2RangeRangeMin/max CO2 equivalent in kg
mkiRangeRangeMin/max MKI score in EUR
certifications[String]Filter by certification IDs
countries[String]ISO country codes
materialTypeStringMaterial composition filter
recycledContentMinFloatMinimum recycled content percentage
hasEpdBooleanProducts with EPD data
hasDppBooleanProducts with a Digital Product Passport

​
Sort options

FieldDescription
CO2_EQUIVALENTSort by carbon footprint
MKI_SCORESort by MKI score
NAMEAlphabetical by name
CREATED_ATNewest first
RELEVANCESearch relevance (default)

​
Faceted results

Search responses include facets for building filter UIs: 
{
  "facets": {
    "sectorTag": [
      { "value": "HIGHTECH_MANUFACTURING", "count": 42 },
      { "value": "TRADE", "count": 18 }
    ],
    "certifications": [
      { "value": "ISO14001", "count": 35 },
      { "value": "BREEAM", "count": 12 }
    ]
  }
}

​
Autocomplete

For search-as-you-type experiences: 
query {
  autocomplete(query: "bio-bas", limit: 5) {
    suggestions {
      text
      type
      id
    }
  }
}