`nutrition.facts`

Energy and nutrients for a food and serving, with alternative servings.

Version 1 · schema nutrition.facts.v1.schema.json

Layouts

Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.

Fields

The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.

Field	Type	Required	Notes
`food`	`object`	yes
`food.name`	`string`	yes
`food.description`	`string \| null`
`serving`	`object`	yes
`serving.label`	`string`	yes
`serving.grams`	`number`	yes
`serving.alternatives[]`	`object[]`	yes
`serving.alternatives[].label`	`string`	yes
`serving.alternatives[].grams`	`number`	yes
`energy_kcal`	`number`	yes
`energy_split_pct`	`object`	yes	Share of energy from each macronutrient; sums to 100.
`energy_split_pct.carbohydrates`	`number`	yes
`energy_split_pct.protein`	`number`	yes
`energy_split_pct.fat`	`number`	yes
`nutrients[]`	`object[]`	yes
`nutrients[].key`	`string`	yes
`nutrients[].label`	`string`	yes	In the answer locale.
`nutrients[].amount`	`number`	yes
`nutrients[].unit`	`enum`	yes	g · mg · µg
`nutrients[].daily_value_pct`	`number \| null`	yes	Of the US FDA daily value; null when there is none.

Example

A recorded answer to “How many calories are in a banana?”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_ebc39049696a",
4  "matched": true,
5  "locale": "en",
6  "skill": "nutrition",
7  "confidence": 0.96,
8  "text": "A medium banana (118 g) has about 105 kcal, mostly from carbohydrates: 27 g, including 14 g of sugars. It also gives you 3.1 g of fiber and 422 mg of potassium.",
9  "speech": "A medium banana has about 105 calories.",
10  "card": {
11    "type": "nutrition.facts",
12    "version": 1,
13    "data": {
14      "food": {
15        "name": "Banana",
16        "description": "raw"
17      },
18      "serving": {
19        "label": "1 medium",
20        "grams": 118,
21        "alternatives": [
22          {
23            "label": "1 small",
24            "grams": 101
25          },
26          {
27            "label": "1 large",
28            "grams": 136
29          }
30        ]
31      },
32      "energy_kcal": 105,
33      "energy_split_pct": {
34        "carbohydrates": 93,
35        "protein": 4,
36        "fat": 3
37      },
38      "nutrients": [
39        {
40          "key": "carbohydrates",
41          "label": "Carbohydrates",
42          "amount": 27,
43          "unit": "g",
44          "daily_value_pct": 10
45        },
46        {
47          "key": "fiber",
48          "label": "Fiber",
49          "amount": 3.1,
50          "unit": "g",
51          "daily_value_pct": 11
52        },
53        {
54          "key": "sugars",
55          "label": "Sugars",
56          "amount": 14.4,
57          "unit": "g",
58          "daily_value_pct": null
59        },
60        {
61          "key": "protein",
62          "label": "Protein",
63          "amount": 1.3,
64          "unit": "g",
65          "daily_value_pct": 3
66        },
67        {
68          "key": "fat",
69          "label": "Fat",
70          "amount": 0.39,
71          "unit": "g",
72          "daily_value_pct": 0
73        },
74        {
75          "key": "potassium",
76          "label": "Potassium",
77          "amount": 422,
78          "unit": "mg",
79          "daily_value_pct": 9
80        },
81        {
82          "key": "vitamin_b6",
83          "label": "Vitamin B6",
84          "amount": 0.43,
85          "unit": "mg",
86          "daily_value_pct": 25
87        },
88        {
89          "key": "vitamin_c",
90          "label": "Vitamin C",
91          "amount": 10.3,
92          "unit": "mg",
93          "daily_value_pct": 11
94        }
95      ]
96    }
97  },
98  "sources": [
99    {
100      "name": "USDA FoodData Central",
101      "url": "https://fdc.nal.usda.gov",
102      "license": "Public domain"
103    }
104  ],
105  "follow_ups": [
106    "And a large one?",
107    "How much protein is in 100 g of cooked lentils?"
108  ],
109  "actions": [],
110  "usage": {
111    "billable": true
112  }
113}