To illustrate how to use Whisk’s API, we’ll take a look at the search API endpoint as an example. You can search for recipes based on a phrase in this live demo. Here’s what Whisk will return when searching for “pita”.

curl "https://graph.whisk.com/v1/users/?externalUserId=433201117" \-H "Accept: application/json" \-H "Authorization: Bearer <Access-Token>"

Health Scores are calculated on a 1-10 scale based on nutrient density and USDA recommendations for a healthy diet. A higher Health Score means healthier food.

Whisk will generate it's own food log record identifier anyway. Food type food_type field is used to reference the source of nutritional information for a food item.

A client token allows you to access a limited subset of Whisk APIs in read-only mode. You can embed a client token into native mobile binaries or desktop apps to identify your app. This token is not meant to be a secret identifier because it is embedded in apps.

curl -X GET "https://api.whisk.com/food/v2/autocomplete?query=app&language=en&country=gb&limit=5" …

The Whisk Graph API uses OAuth 2.0 to allow developers to get a user access token to access a single user’s data or do actions on their behalf. OAuth 2.0 is a specification outlined in RFC 6749 that allows third-party services to make requests on behalf of a user without accessing passwords and other sensitive information.

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.

GET https://api.whisk.com/provision/v2/dictionaries. Method developed to get provision data for user. For example get list of all tags for review.

At Whisk, we provide you token based access to our API for integration. Here are the different token types that we support: In this API reference documentation, each endpoint description includes information the token type required to access it.