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.

​
product

Retrieve a single product by ID. 
query {
  product(id: "prod_abc123") {
    id
    name
    sectorTag
    materialComposition {
      name
      percentage
      isBioBased
      recycledContent
    }
    impactScore {
      co2Equivalent
      mkiScore
      waterFootprint
      equivalencies {
        description
        value
        icon
      }
      breakdown {
        phase
        contribution
        percentage
      }
    }
    certifications
    sectorMetadata
  }
}
Arguments:
ArgumentTypeRequiredDescription
idID!YesProduct identifier

​
products

List products with filtering and sorting. 
query {
  products(
    first: 20
    after: "cursor_abc"
    filter: {
      sectorTag: FOOD
      co2Range: { min: 0, max: 50 }
    }
    sort: { field: CO2_EQUIVALENT, direction: ASC }
  ) {
    totalCount
    edges {
      node {
        id
        name
        sectorTag
        impactScore {
          co2Equivalent
          mkiScore
        }
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
Arguments:
ArgumentTypeRequiredDescription
firstIntNoResults to return (default: 20, max: 100)
afterStringNoCursor for pagination
filterProductFilterNoFilter criteria
sortProductSortNoSort order

​
ProductFilter

FieldTypeDescription
sectorTagSectorTagFilter by sector
co2RangeRangeInputCO2 equivalent range
mkiRangeRangeInputMKI score range
certifications[String!]Required certifications
hasEpdBooleanHas EPD data
hasDppBooleanHas Digital Product Passport

​
productDetailPage

Optimized endpoint for front-end product detail pages with pre-calculated data and edge caching support. 
query {
  productDetailPage(id: "prod_abc123", locale: "nl") {
    product {
      id
      name
      sectorTag
    }
    impactScore {
      co2Equivalent
      mkiScore
      equivalencies {
        description
        value
        icon
      }
    }
    comparison {
      averageInSector
      percentileBetter
      label
    }
    badges {
      name
      icon
      description
    }
    dppUrl
    visualisationParams {
      lottieTemplate
      parameters
    }
  }
}
The productDetailPage query is optimized for <100ms response times. Results are edge-cached with a 1-hour TTL.