Variety Score

Quantify the dietary diversity of a user's meals over time. Variety Score evaluates how balanced and diverse the diet is based on food groups, meal frequency, and nutritional variety.

Use this feature together with Nutritional Reports, Recipe and Dish Recommendations, and Intake History to assess diet quality and provide feedback to users.

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Analyse

Monitor

Recommend

Custom

Accessible by the following User Types:

🔴 APIUser

What It Does

The Variety Score feature provides a numerical measure of how diverse and balanced a user's dietary intake is over a specific period. It uses the history of submitted intakes (manual or image-based) and analyzes the distribution of food groups and dish categories consumed. A higher score indicates a more varied diet, while lower values suggest repetitive eating patterns or nutrient imbalance.

variety score nutrition diversity nuts and seeds

food variety balance vegetables and fruits

When to Use It / Outcomes

You want to track a user’s diet quality beyond calorie counting or nutritional indicators tracking.
You want to quantify meal variety for nutrition programs, coaching, or personalized feedback.
You want to motivate users by showing progress toward a balanced, diverse diet.

Feature-Specific Details

Calculation basis: derived from user intake history, analyzing the number and diversity of unique dishes, food groups, and nutrients consumed.
Scoring range: 0–100, where 100 represents an ideal variety across all major food groups.
Data dependency: uses data from Intakes History, and Nutritional Reports.
Time windows: configurable (e.g., daily, weekly, monthly).

Related Endpoints

Use the following endpoints to compute or retrieve the Variety Score:

GET /score/variety → ⚫ 🔴 🔵 Retrieve the variety score for a specific user over a chosen time period.
Optional helper:
- GET /history/getIntakesList → ⚫ 🔴 🔵 Retrieve all intakes that feed into the score calculation.
- GET /dataset/foodGroups → ⚫ 🔴 🔵 Get the list of food groups used in the scoring model.

Typical Workflow

Collect intake history: Retrieve the user’s intakes using GET /history/getIntakesList.
Compute score: Call GET /score/variety to calculate the variety score for the desired time frame.
Display results: Show the returned variety_score, group_distribution, and improvement suggestions in your UI or dashboard.
Monitor progress: Periodically re-calculate the score (daily or weekly) to visualize user progress.