Get Food

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

Description

Swagger doc

Returns brand, nutrition data and available measurements for food

Parameters

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

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.

Last updated