Nutritional Information

See also: Ingredients Information and Recommended Daily Intake.

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Accessible by the following User Types:

What It Does

The Nutritional Information feature returns a nutrient profile for a food item or a recognized dish. Typical outputs include energy (kcal), macronutrients and a selection of micronutrients.
It sits downstream of recognition: you usually call it after detecting dishes and (optionally) confirming quantity and ingredients to make the results user‑specific. This feature also works for any manually submitted food intake.

✕

✕

When to Use It / Outcomes

• You need calories, macros and micros for a recognized dish or an ingredient list (diet logging, coaching apps, dashboards).
• You want to compare intake vs. goals (pair with Recommended Daily Intake and Daily Goals).
• You build image‑based or manually reported food diaries and need per‑meal nutrition attached to the user’s history.

Output: JSON with nutrient fields (energy, macro/micro amounts) optionally normalized by portion after quantity confirmation.

Feature-Specific Details

• Portion‑aware results — quantities are adjusted once you confirm serving size via the quantity confirmation endpoint.
• Ingredient‑aware results — users can review/modify the detected ingredients to better match their recipe before computing nutrition.
• Computation from custom recipes — compute nutrition directly from a list of ingredients (no image) using the recipe nutrients endpoint.

Notes & Tips

• For best accuracy, confirm quantity and ingredients before requesting nutrition.
• Use user profile preferences (e.g., added sugar/oil/salt) to personalize computed nutrition.
• Pair with Recommended Daily Intake to provide contextual targets for users.

Related Endpoints

• POST /nutrition/recipe/nutritionalInfo → 🔴 Returns nutrient breakdown for a recognized dish (energy, macro/micro values).
• GET /info/nutrients → ⚫ 🔴 🔵 Retrieve the catalog of nutrients available.
• POST /nutrition/confirm/quantity → 🔴 🔵 Confirm serving size (by imageId); normalizes nutrition to the user’s portion.
• POST /nutrition/confirm/ingredients → 🔴 🔵 Confirm or edit ingredients (and amounts) for the dish before computing nutrition.
• POST /nutrition/recipe/compute_nutrients → 🔴 🔵 Compute nutrition from a list of ingredients (no image required).

Remember to check applicable request limitations inside each of the endpoints.

Related Use Cases

Copy-Paste Recipes

Set profile data once to improve label language and regional dishes:

Send the image for segmentation to obtain regions and top dish candidates per region. Display the top 5 candidate dishes per region.

Retrieve the nutritional information (macro & micro nutrients) for the confirmed dishes: