# Get Food ### Description [Swagger doc](https://api.whisk.com/spec/#/FoodAPI/FoodAPI_GetFood) Returns brand, nutrition data and available measurements for food ### Parameters
NameOptionalTypeDescription
food_hitsnoarray[string]Food identifiers to be fetched
response_mask.pathsyesarray[string]List of top level fields of result model to be returned. Minimal required set of fields should be specified to reduce payload size
#### Request example The recommended set of fields to request to cover the common use case of displaying a product is ``` title brand nutrition measures ``` ```bash curl -X GET "https://api.whisk.com/food/v2/get?food_hits=CiMyMDJlNjM2M2Q3YWRkNjU0ZmI2OGZmZTNkZGM1ODliMzY5ZA==&food_hits=CiMyMDI2OTdjYjQ5MGU5YmM0MTMzYTg5OWYzOWJhZTI3NmEyZQ==&language=en&country=gb&response_mask.paths=title&response_mask.paths=brand&response_mask.paths=nutrition&response_mask.paths=measures" -H "accept: application/json" -H "Authorization: Bearer %WHISK_TOKEN%" ``` ### Response Data returned in JSON. Empty strings, zero values, empty arrays and null values are not returned. #### Json response example with the proper response\_mask.paths specified ```json { "food": [ { "title": "apple", "measures": { "measures_with_nutrition": [ { "nutrition": { "nutrition": [ { "unit_name": "NUTRITION_UNIT_MKG", "code": "NUTRITION_CODE_VITB12" }, { "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_CHOLE" }, { "amount": 10.100000381469727, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_SUGAR" }, { "amount": 0.6000000238418579, "unit_name": "NUTRITION_UNIT_MKG", "code": "NUTRITION_CODE_VITK1" }, { "amount": 0.03999999910593033, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FAPU" }, { "amount": 0.019999999552965164, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FASAT" }, { "amount": 12.760000228881836, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_CHOCDF" }, { "unit_name": "NUTRITION_UNIT_MKG", "code": "NUTRITION_CODE_FOL" }, { "amount": 11.399999618530273, "unit_name": "NUTRITION_UNIT_MKG", "code": "NUTRITION_CODE_VITA_RAE" }, { "amount": 0.05000000074505806, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_ZN" }, { "amount": 0.029999999329447746, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_RIBF" }, { "amount": 0.12999999523162842, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FAT" }, { "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FAMS" }, { "amount": 0.27000001072883606, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_PROCNT" }, { "amount": 11, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_P" }, { "amount": 4, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_VITC" }, { "amount": 90, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_K" }, { "amount": 4, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_MG" }, { "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FATRN" }, { "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_NA" }, { "amount": 0.05000000074505806, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_TOCPHA" }, { "amount": 1.2999999523162842, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FIBTG" }, { "amount": 0.03999999910593033, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_VITB6A" }, { "amount": 47.79999923706055, "unit_name": "NUTRITION_UNIT_KCAL", "code": "NUTRITION_CODE_ENERC_KCAL" }, { "amount": 0.019999999552965164, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_THIA" }, { "amount": 5, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_CA" }, { "unit_name": "NUTRITION_UNIT_MKG", "code": "NUTRITION_CODE_VITD" }, { "amount": 0.09000000357627869, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_NIA" }, { "amount": 0.07000000029802322, "unit_name": "NUTRITION_UNIT_MG", "code": "NUTRITION_CODE_FE" } ] }, "measures": [ { "amount": 4.625121890828984, "name": "small", "measure_unit": "MEASURE_UNIT_OZ", "nutrition_coefficient": 1.3112000000000001 }, { "amount": 131.12, "name": "small", "measure_unit": "MEASURE_UNIT_G", "nutrition_coefficient": 1.3112000000000001 }, { "amount": 5.649477745844799, "name": "medium", "measure_unit": "MEASURE_UNIT_OZ", "nutrition_coefficient": 1.6016 }, { "amount": 160.16, "name": "medium", "measure_unit": "MEASURE_UNIT_G", "nutrition_coefficient": 1.6016 }, { "amount": 3.5273961949580412, "name": "100 G", "measure_unit": "MEASURE_UNIT_OZ", "nutrition_coefficient": 1 }, { "amount": 100, "name": "100 G", "measure_unit": "MEASURE_UNIT_G", "nutrition_coefficient": 1 }, { "amount": 182, "name": "medium", "measure_unit": "MEASURE_UNIT_G", "nutrition_coefficient": 1.82 }, { "amount": 6.922162292985661, "name": "large", "measure_unit": "MEASURE_UNIT_OZ", "nutrition_coefficient": 1.9624000000000001 }, { "amount": 196.24, "name": "large", "measure_unit": "MEASURE_UNIT_G", "nutrition_coefficient": 1.9624000000000001 } ] } ] }, "food_hit": "CiMyMDI2OTdjYjQ5MGU5YmM0MTMzYTg5OWYzOWJhZTI3NmEyZQ==" } ] } ``` #### Core Attributes In case `response_mask.paths` `brand, title, nutrition, measures` as in the example above are passed
NameOptionalTypeDescription
titlenostringLocalized food name
brandyesstringBrand name
measuresyesobjectWrapper object for a list of measures
measures.measures_with_nutritionnoarrayList of measurements specific to this food along with the nutrition per 100 g
measures.measures_with_nutrition.measures.amountnodoubleNumber of measure_unit within one measure e.g. slice of cheese is 20g, cup of milk is 240ml. Not rounded
measures.measures_with_nutrition.measures.measure_unitnoenumMEASURE_UNIT_G | MEASURE_UNIT_ML | MEASURE_UNIT_OZ | MEASURE_UNIT_FL_OZ
measures.measures_with_nutrition.measures.nutrition_coefficientnodoubleMultiplier to use with nutrition per 100g to get nutrition of measure. It's derived from product density
measures.measures_with_nutrition.measures.namenostringLocalized measurement name e.g. slice
measures_with_nutrition.nutritionnoobjectWrapper object for nutrition list
measures_with_nutrition.nutrition.nutritionnoarrayList of nutrition components
measures_with_nutrition.nutrition.nutrition.amountyesdoubleAmount of nutrition component per 100g of the food
measures_with_nutrition.nutrition.nutrition.unit_namenoenumNUTRITION_UNIT_G | NUTRITION_UNIT_MG | NUTRITION_UNIT_MKG | NUTRITION_UNIT_KCAL
Macronutrients and Fiber are returned in grams
Micronutrients are returned either in milligrams of micrograms
Energy is returned in Kilocalories
measures_with_nutrition.nutrition.nutrition.codenoenumSee below
#### Nutrition codes Whisk is always trying to provide full up to date nutritional data, although all nutrition codes for food are not always available. Nutrition codes for missing data are not returned. * NUTRITION\_CODE\_ENERC\_KCAL: Energy * NUTRITION\_CODE\_FAT: Total Fat * NUTRITION\_CODE\_FASAT: Saturated Fat * NUTRITION\_CODE\_CHOCDF: Carbohydrate Total * NUTRITION\_CODE\_SUGAR: Sugars * NUTRITION\_CODE\_PROCNT: Protein * NUTRITION\_CODE\_NA: Sodium * NUTRITION\_CODE\_FIBTG: Fiber * NUTRITION\_CODE\_FATRN: Trans Fat * NUTRITION\_CODE\_FAMS: Monounsaturated Fat * NUTRITION\_CODE\_FAPU: Polyunsaturated Fat * NUTRITION\_CODE\_FAT\_UNSAT: Unsaturated Fat * NUTRITION\_CODE\_CHOLE: Cholesterol * NUTRITION\_CODE\_CA: Calcium * NUTRITION\_CODE\_MG: Magnesium * NUTRITION\_CODE\_K: Potassium * NUTRITION\_CODE\_FE: Iron * NUTRITION\_CODE\_ZN: Zinc * NUTRITION\_CODE\_P: Phosphorus * NUTRITION\_CODE\_VITA\_RAE: Vitamin A * NUTRITION\_CODE\_VITC: Vitamin C * NUTRITION\_CODE\_THIA: Thiamin B1 * NUTRITION\_CODE\_RIBF: Riboflavin B2 * NUTRITION\_CODE\_NIA: Niacin B3 * NUTRITION\_CODE\_VITB6A: Vitamin B6 * NUTRITION\_CODE\_FOL: Folic Acid B9 * NUTRITION\_CODE\_VITB12: Vitamin B12 * NUTRITION\_CODE\_VITD: Vitamin D * NUTRITION\_CODE\_TOCPHA: Vitamin E * NUTRITION\_CODE\_VITK1: Vitamin K #### Imperial measures When country is specified in the request and is one of USA, UK, Canada, then Whisk API will return measures in both Metric and Imperial systems. #### Measures and nutrition explained To support volume based measures we've introduced a `nutrition_coefficient` attribute. Let's see it on the following example ``` "title":"milk", "measures_with_nutrition": [ { "nutrition": { "nutrition": [ { "amount": 60, "unit_name": "NUTRITION_UNIT_KCAL", "code": "NUTRITION_CODE_ENERC_KCAL" }, { "amount": 3.200000047683716, "unit_name": "NUTRITION_UNIT_G", "code": "NUTRITION_CODE_FAT" } ] }, "measures": [ { "amount": 240, "name": "cup", "measure_unit": "MEASURE_UNIT_ML", "nutrition_coefficient": 2.448 }, { "amount": 100, "name": "100 Ml", "measure_unit": "MEASURE_UNIT_ML", "nutrition_coefficient": 1.02 } ] } ] ``` \ Whisk API returns nutrition per `100g` in metric units. It's a standard adopted all over the world including USDA and KFDA. The response above means: There's `60 kCal` and `3.2g` of Fat in `100g` of Milk. The cup of milk has volume of `240 ml` or `8.11 fl oz`. The cup of milk weights `2.448` times more than `100g` of milk.\ So the cup of milk has `60 * 2.448 = 146.88 kCal` and `3.2 * 2.448 = 7.8g` of Fat. Sometimes one product may come with different attributes e.g. `cooked` or `fried`. Since nutrition of `cooked` product is different, it will come as a separate item within `measures_with_nutrition` array.