Verateca

Searches the Verateca register of dietary supplements by product name, brand, ingredient or barcode. Returns up to 10 published products with id, brand, form, page address, lowest price per day where prices are published, number of offers and the date the record was checked. Results are ordered by match, never by payment.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product name, brand, ingredient or barcode (UPC/EAN)."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Number of results, 1–10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Returns one published product record: composition as the label states it, daily amounts, the applicable upper limit of the country for each ingredient with its share, limits of other countries, the status in the country, prices per day where published, and the dates of each part.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Verateca product id, e.g. \"US:302778\", as returned by search_products."
    },
    "url": {
      "type": "string",
      "description": "Verateca product page address, as an alternative to id."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    }
  },
  "additionalProperties": false
}

Returns one substance of the register: its forms with the share of the element where known, the upper limit of the country first, then the limits of other countries with type, source and the date checked, reference sources, and the number of published products that contain it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Substance id, e.g. \"magnesium\", \"vit_d\"."
    },
    "name": {
      "type": "string",
      "description": "Substance name, e.g. \"Vitamin D\", as an alternative to id."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    }
  },
  "additionalProperties": false
}

Adds up each ingredient across several products taken together (up to 12) and compares each daily total with the adult upper limit of the country, with the same rules engine as the Verateca site. For every ingredient: total per day, applicable limit, share of the limit, status ("within the upper limit", "over the upper limit", "no upper limit set" or "not compared"), the products that contribute, and duplicates across products. Limits of other countries follow. Interactions with medicines are not checked.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "description": "Products taken together.",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "description": "Verateca product id, e.g. \"US:302778\", as returned by search_products."
          },
          "servings_per_day": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 20,
            "description": "Servings a day the person takes. Default: the label dose."
          }
        },
        "required": [
          "product_id"
        ],
        "additionalProperties": false
      }
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

Puts 2 to 6 published products side by side: daily dose, price per day where published, and for each ingredient the daily amount and its share of the applicable upper limit of the country.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "minItems": 2,
      "maxItems": 6,
      "items": {
        "type": "string"
      },
      "description": "Product ids, e.g. [\"US:302778\", \"US:217710\"]."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    }
  },
  "required": [
    "ids"
  ],
  "additionalProperties": false
}

Returns the address of the Verateca order page for one of its three paid services (quick, full, review), with the price and currency the site shows for the country and a one-line description. The tool takes no payment and creates no order; the order page asks its own questions and takes payment there.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "enum": [
        "quick",
        "full",
        "review"
      ],
      "description": "quick: up to three products for one goal; full: one set for up to three goals; review: a written review by a Verateca specialist."
    },
    "goals": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "stress",
          "energy",
          "digestion",
          "sleep",
          "immunity",
          "bones",
          "skin",
          "sport",
          "eyes"
        ]
      },
      "maxItems": 3,
      "description": "Optional goals to preselect on the order page (quick: 1, full: up to 3; ignored for review). They travel sealed, not in plain words."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2) of the person. Limits of this country come first. Default US.",
      "default": "US"
    }
  },
  "required": [
    "service"
  ],
  "additionalProperties": false
}