Nutritional Scoring
Learn more about Nutritional Analysis and Food Composition in the Nutritional Reports & Summaries section.
Plan & Token Requirements
Feature available in the following LogMeal Plans:
Accessible by the following User Types:
🔴 APIUser
What It Does
Nutri-Score is a feature that grades the nutritional quality of a dish or food item using a five-letter color-coded scale from A (healthiest) to E (least healthy). It evaluates the balance between positive components (fiber, protein, fruits, vegetables) and negative components (saturated fats, sugars, sodium, energy density). This provides an intuitive, single-score indicator for users and organizations to compare the nutritional healthiness of meals.


When to Use It / Outcomes
-
You want to evaluate the nutritional quality of a dish or product using an established European scoring model adapted on the LogMeal database.
-
You want to compare meals based on their nutrient profiles.
-
You want to offer visual nutrition feedback to users within your app or reports.
-
Output: JSON with:
nutri_score_letter
→ A–Enutri_score_value
→ numerical score (−15 to +40)positive_points
→ contribution from healthy nutrientsnegative_points
→ contribution from less healthy nutrientsdetailed_components
→ breakdown of scoring factors (energy, sugar, fat, sodium, etc.)
Feature-Specific Details
-
Scoring method: Based on the official Nutri-Score algorithm used across the EU and WHO recommendations.
-
Input data: Derived from the nutritional composition of an intake, dish, or recipe.
-
Scale:
- A (dark green): Excellent nutritional quality
- B (light green): Good quality
- C (yellow): Moderate balance
- D (orange): Low quality
- E (red): Poor quality
-
Automatic computation: Included in Nutritional Analysis outputs for both image-based and manual intakes.
-
Use cases: Can be applied per-dish or per-meal for complete nutritional assessments.
Related Endpoints
Use the following endpoints to retrieve or compute Nutri-Score data dynamically:
- GET /score/{imageId}/nutriScore → 🔴 Retrieve Nutri-Score for a recognized dish or image.
- GET /score/{date}/meal/{occasion}/nutriScore → 🔴 Retrieve Nutri-Score for a meal on a specific date and occasion (e.g., breakfast, lunch, dinner).
- GET /score/{date}/meal/nutriScore → 🔴 Retrieve overall Nutri-Score for a given date (aggregated daily score).
Typical Workflow
- Analyze meal or dish: Perform nutritional analysis by uploading any intake based on image, manual input or with any other method.
- Retrieve Nutri-Score: Use GET /score/{imageId}/nutriScore for an image or GET /score/{date}/meal/{occasion}/nutriScore for a meal.
- Display grade: Present the Nutri-Score visually (A–E color badge) in your UI.
- Compare and store: Compare scores over time or between meals; store results with intake data.
- Aggregate reports: Use results in nutritional reports and progress dashboards.
Updated about 11 hours ago