Plate Pal

Calories and macros for a food, dish or product, for the amount the user says. For requests like "how many calories in a Big Mac?", "protein in 200g chicken breast", "calories in chicken biryani", "a slice of pepperoni pizza", "a large latte" or a whole meal like "2 eggs, 2 slices of toast and a coffee". Takes the whole amount and food in q, or grams or servings separately. Generic foods and dishes (thousands, including fast food and restaurant dishes) use USDA values with real portion weights (slice, cup, small, medium, large, one item); brands come from Open Food Facts. Chain items ("McDonald's large fries", "a Greggs sausage roll", "KFC Zinger burger", "grande latte from Starbucks", "6 inch Italian BMT from Subway", "20 piece McNuggets") use the chain's own published figures for that size, UK or US by country, and return a chain object (name, region, item, size, weight_published); when the chain doesn't publish a weight, amount.grams is null and per_100 values are null. For a chain item not in the table, a typical USDA version is used and the say line says so. A whole meal returns items (each food with its amount and nutrition) and total. Returns nutrition for the amount, per_100 values, portions, UK traffic lights (per 100 g, or per 100 ml for drinks) and caffeine_mg for drinks that have it.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The food or meal, optionally with amounts, for example 200g chicken breast, a large banana, or 2 eggs and a slice of toast."
    },
    "grams": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000,
      "description": "Amount in grams (1 to 5000). Overrides any amount in q."
    },
    "servings": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 20,
      "description": "Number of servings or items (0.25 to 20)."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. Picks UK or US chain figures (GB and IE get UK ones) and prefers local versions of branded products. Default from the request."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Nutrition for a packaged product by barcode, with UK traffic lights. For requests like "is this barcode high in sugar?", "how many calories in this?" after a scan, or "what's the salt in 5000157024886?". Returns per 100 g (or 100 ml) and per serving values, traffic lights for fat, saturates, sugars and salt, Nutri-Score, allergens and a Halal or Not? link for checking the ingredients.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Barcode digits (8 to 14)."
    },
    "servings": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 20,
      "description": "Number of servings to total up (0.25 to 20)."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Simple meal ideas by goal, diet and meal, with rough macros. For requests like "give me a high protein halal dinner idea", "a quick vegan lunch", "cheap vegetarian breakfast ideas". Goals: high protein, low carb, budget, quick, high fibre. Diets: vegetarian, vegan, pescatarian, halal. Meals: breakfast, lunch, dinner, snack. The user's words can go in q instead. Ideas rotate daily. It does not set calorie or weight targets; a weight-loss request gets lighter, filling ideas (goal lighter, 450 calories or less) and a pointer to a doctor or dietitian, with no shop links.

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "description": "Goal: high protein, low carb, budget, quick or high fibre."
    },
    "diet": {
      "type": "string",
      "description": "Diet: vegetarian, vegan, pescatarian or halal."
    },
    "meal": {
      "type": "string",
      "description": "Meal: breakfast, lunch, dinner or snack."
    },
    "q": {
      "type": "string",
      "description": "Free text, for example high protein halal dinner."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "How many ideas, 1 to 8. Default 3."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shop links (US, GB and IE get local Amazon links). Default from the request."
    }
  },
  "required": [],
  "additionalProperties": false
}