Get Food

GET https://api.whisk.com/food/v2/get

Description

Swagger doc

Returns brand, nutrition data and available measurements for food

Parameters

Name	Optional	Type	Description
food_hits	no	array[string]	Food identifiers to be fetched
response_mask.paths	yes	array[string]	List of top level fields of result model to be returned. Minimal required set of fields should be specified to reduce payload size

Name

Optional

Type

Description

food_hits

array[string]

Food identifiers to be fetched

response_mask.paths

yes

array[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

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

{
  "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

Name Optional Type Description

Name	Optional	Type	Description
title	no	string	Localized food name
brand	yes	string	Brand name
measures	yes	object	Wrapper object for a list of measures
measures.measures_with_nutrition	no	array	List of measurements specific to this food along with the nutrition per 100 g
measures.measures_with_nutrition.measures.amount	no	double	Number 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_unit	no	enum	MEASURE_UNIT_G \| MEASURE_UNIT_ML \| MEASURE_UNIT_OZ \| MEASURE_UNIT_FL_OZ
measures.measures_with_nutrition.measures.nutrition_coefficient	no	double	Multiplier to use with nutrition per 100g to get nutrition of measure. It's derived from product density
measures.measures_with_nutrition.measures.name	no	string	Localized measurement name e.g. `slice`
measures_with_nutrition.nutrition	no	object	Wrapper object for nutrition list
measures_with_nutrition.nutrition.nutrition	no	array	List of nutrition components
measures_with_nutrition.nutrition.nutrition.amount	yes	double	Amount of nutrition component per 100g of the food
measures_with_nutrition.nutrition.nutrition.unit_name	no	enum	NUTRITION_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.code	no	enum	See below

title

string

Localized food name

brand

yes

string

Brand name

measures

yes

object

Wrapper object for a list of measures

measures.measures_with_nutrition

array

List of measurements specific to this food along with the nutrition per 100 g

measures.measures_with_nutrition.measures.amount

double

Number 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_unit

enum

MEASURE_UNIT_G | MEASURE_UNIT_ML | MEASURE_UNIT_OZ | MEASURE_UNIT_FL_OZ

measures.measures_with_nutrition.measures.nutrition_coefficient

double

Multiplier to use with nutrition per 100g to get nutrition of measure. It's derived from product density

measures.measures_with_nutrition.measures.name

string

Localized measurement name e.g. slice

measures_with_nutrition.nutrition

object

Wrapper object for nutrition list

measures_with_nutrition.nutrition.nutrition

array

List of nutrition components

measures_with_nutrition.nutrition.nutrition.amount

yes

double

Amount of nutrition component per 100g of the food

measures_with_nutrition.nutrition.nutrition.unit_name

enum

NUTRITION_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.code

enum

See 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.

PreviousSearch NextFood List

Last updated 1 year ago