Foods come from four libraries, and every food is pointed at by its library and key.

{
  "library": "off",
  "key": "3017620422003",
  "version": 1,
  "name": "Nutella",
  "brand": "Ferrero",
  "barcode": "3017620422003",
  "data": {
    "base": "g",
    "nutrition": {
      "basisAmount": 100,
      "values": { "kcal": 539, "protein": 6.3, "carbs": 57.5, "fat": 30.9, "saturatedFat": 10.6, "sugars": 56.3, "salt": 0.11 }
    },
    "measures": [{ "label": "tablespoon", "size": 15 }],
    "defaultPortion": { "amount": 15, "unit": "g" }
  }
}

Libraries

Library	Holds
mine	Your own foods and recipes. Only you see them.
composition	Generic ingredients such as eggs or rice.
splot	Packaged products in the Splot database.
off	Packaged products from Open Food Facts.

Fields

Field	Type	Description
library	string	The library the food lives in. One of off, splot, mine or composition.
key	string	Its key in that library. Send library and key as food to log it.
version	integer	Foods change over time; meals and recipes keep the version they were saved with.
name	string	The food's name.
brand	string or null	The brand, for packaged products.
barcode	string or null	The barcode, for packaged products.
data	object	Nutrition, portions and recipe details.

Data

Field	Type	Description
base	string	The unit nutrition is given in. One of g, ml or serving.
nutrition	object	Nutrients for basisAmount of the base unit, such as per 100 g. A nutrient left out is unknown, not zero.
measures	array	Other portions by name, each { "label", "size" } in the base unit, such as a tablespoon of 15 g. Up to 30 items.
defaultPortion	object	The usual portion, as { "amount", "unit" }.
composition	string	Ingredients as printed on the label. Up to 10,000 characters.
note	string	Anything else worth knowing. Up to 10,000 characters.
images	array	Photos, as public links or saved Splot photos. Up to 20 items.
recipe	object	For a recipe: its servings, optional minutes, and steps.
source	object	Where the values come from, such as { "origin": "label" }, or estimate with a description.
ingredients	array	For a recipe: its foods, each with a portion.
thumbnail	string	Optional public Storage path for a small food image. Read-only; omit when saving a food.

A recipe’s nutrition is added up from its ingredients, per serving. Each nutrient counts the ingredients that list it; one that none of them list is left out.