Rank foods by a nutrient
nutrient_rankingRanks whole plant foods by the amount of one nutrient per 100 g of edible portion, optionally within one food category. Each row of results gives the value per 100 g, the number of sources behind it and, where heathy.org holds a typical serving for the food, that serving and the amount in it; the order is per 100 g. Foods eaten a few grams at a time (dried herbs, spices, tea leaves, and dried seaweed, mushrooms and vegetables) are not ranked in results. They are reported beside it in also_higher.small_amounts: a count of those holding more per 100 g than the last row, and the first five. They are ranked in results when include_small_amounts is true, and when the category filter selects mostly such foods ("spice", "tea", "seaweed"). With min_sources above 1, foods measured by fewer sources are reported in also_higher.fewer_sources in the same way. A nutrient that reads 0 on every food returns an explanation in all_zero and no ranking.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results, 1–100. Default 20. | |
| category | No | Optional substring filter on the food category — e.g. "fruit", "legume", "millet". | |
| nutrient | Yes | Nutrient slug or name — e.g. "iron", "vitamin-c", "folate". | |
| min_sources | No | Smallest number of sources behind a value for its food to be ranked in results (1–32). Default 1. Above 1, foods measured by fewer sources are counted in also_higher.fewer_sources. | |
| include_small_amounts | No | true ranks the foods eaten a few grams at a time (dried herbs, spices, tea leaves, dried seaweed, mushrooms and vegetables) in results with every other food. Default false. |