Supplementenscanner

Find the cheapest supplements by normalized price-per-unit within a category (and all its subcategories). This is the primary tool for "what is the cheapest X?" questions. Use list_categories first to pick a valid category_slug.

{
  "type": "object",
  "properties": {
    "category_slug": {
      "description": "The category to search within, e.g. \"whey-protein\" or \"creatine\". Products in every subcategory are included, so a parent slug like \"protein-powder\" works too. Get valid slugs from list_categories.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of products to return (1-50).",
      "default": 10,
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "in_stock_only": {
      "description": "When true, only return products currently in stock.",
      "default": false,
      "type": "boolean"
    },
    "market": {
      "description": "Optional country market to query: nl, be, fr, gb, pl, es, dk, at. Defaults to nl, the market this endpoint answers for. Any other value is rejected.",
      "type": "string"
    }
  },
  "required": [
    "category_slug"
  ]
}

Search the whole supplement catalog by product name or brand. Typo-tolerant (e.g. "kreatine", "theanin" still match). Results are ordered by relevance, then cheapest normalized price-per-unit. Use find_cheapest instead when you already know the category.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "The product name or brand to search for, e.g. \"whey isolaat\" or \"magnesium bisglycinaat\".",
      "minLength": 2,
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of products to return (1-50).",
      "default": 20,
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "in_stock_only": {
      "description": "When true, only return products currently in stock.",
      "default": false,
      "type": "boolean"
    },
    "category_slug": {
      "description": "Optional: restrict results to this category and all of its subcategories, e.g. \"protein-powder\". Must be a slug from list_categories; an unknown slug is rejected.",
      "type": "string"
    },
    "max_unit_price_cents": {
      "description": "Optional: only return products whose normalized unit price, rounded to whole cents, is at or below this many cents.",
      "minimum": 0,
      "type": "integer"
    },
    "market": {
      "description": "Optional country market to query: nl, be, fr, gb, pl, es, dk, at. Defaults to nl, the market this endpoint answers for. Any other value is rejected.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

List the supplement categories that currently hold priced products, each with a live product count, store count, lowest normalized unit price, and its comparison basis (per_kg / per_serving / per_capsule). Use this to discover a valid category_slug for find_cheapest.

{
  "type": "object",
  "properties": {
    "market": {
      "description": "Optional country market to query: nl, be, fr, gb, pl, es, dk, at. Defaults to nl, the market this endpoint answers for. Any other value is rejected.",
      "type": "string"
    }
  }
}

Get full detail for one product by its id: price, normalized unit price, size, bulk/staffel tiers, buy link, and recent price history. Use the id returned by find_cheapest or search_products.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "The numeric product id, as returned in the `id` field by find_cheapest or search_products.",
      "type": "integer"
    },
    "market": {
      "description": "Optional country market to query: nl, be, fr, gb, pl, es, dk, at. Defaults to nl, the market this endpoint answers for. Any other value is rejected.",
      "type": "string"
    }
  },
  "required": [
    "product_id"
  ]
}