TheBetterBuy Product Comparison

Search TheBetterBuy product catalog. Returns a slimmed list of products (title, slug, brand, price, image, number of offers) plus a total count. Use list_categories to discover valid category values. Sorting is only supported by price.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search across product title and GTIN. Omit to browse all products.",
      "type": "string"
    },
    "category": {
      "description": "Category tag in underscored form (e.g. 'Power_Tools') as returned by list_categories.",
      "type": "string"
    },
    "brand": {
      "description": "Exact brand name to filter by.",
      "type": "string"
    },
    "minPrice": {
      "description": "Minimum price (inclusive).",
      "type": "number"
    },
    "maxPrice": {
      "description": "Maximum price (inclusive).",
      "type": "number"
    },
    "hasImages": {
      "description": "If true, only return products that have images.",
      "type": "boolean"
    },
    "sortBy": {
      "description": "Field to sort by. Only 'price' is supported.",
      "type": "string",
      "enum": [
        "price"
      ]
    },
    "order": {
      "description": "Sort direction when sortBy is set. Defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "1-based page number. Defaults to 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a single full product by slug (preferred) or GTIN, including all retailer offers (sources). Provide exactly one of slug or gtin.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Product slug (primary key).",
      "type": "string"
    },
    "gtin": {
      "description": "Product GTIN/EAN/UPC. Used when slug is unknown.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the retailer offers (price, link, shipping/returns info) for a product identified by slug or GTIN, plus affiliate-link fallbacks. Provide exactly one of slug or gtin.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Product slug (primary key).",
      "type": "string"
    },
    "gtin": {
      "description": "Product GTIN/EAN/UPC. Used when slug is unknown.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the available product categories with their filter tag, human-readable name, and product count. Use the returned 'category' value as the category filter in search_catalog.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}