Whisk Docs
Whisk HomeHelp CenterDeveloper Tools
v1.0.0
v1.0.0
  • Overview
  • Guides
    • Creating An Account
    • Getting Started
    • Whisk Sandbox
  • API
    • Authentication
      • Server Token
      • Client Token
      • User Access Token
      • Anonymous Access
    • Recipes
      • Get Recipe
      • Get Recipe Categories
      • Recipe Objects
    • Recipe Discovery
      • Recipe Feed
      • Recipe Search
      • Get Similar Recipes
    • Shopping Lists
      • Get Shopping Lists
      • Create A Shopping List
      • Add Items To A Shopping List
      • List Analysis
    • Meal Plans
      • Meal Plan Management
      • Delete Meals
      • Auto-Generator
      • Error Handling
    • Retailers
      • Get Available Stores
      • Retailers Checkout Flow
      • Retailer Aliases
      • OAuth Retailer Flow
      • Retailer User Info
      • Search Store Items
    • Carts
      • Create a Cart
      • Update Cart Item
      • Splitting Combined Items
      • Add Items To Cart
      • Add Recipes To Cart
      • Get Cart Item Options
      • Swap Cart Item Product
      • Delete A Cart Or A Cart Item
      • Checkout
    • Users
      • Get A User
      • Update A User
    • User Recipes & Collections
      • Add User Recipe
      • Create A Recipe
      • Update External Recipe
      • Get All User Recipes
      • Update User Recipe
      • Remove Recipe from Favorites
      • Create Collection
      • Get All User Collections
      • Get Collection
      • Get Recipes from a Collection
      • Remove Collection
    • Tools
      • Autocomplete
  • Shopping List SDK
    • Overview
    • Examples
      • Shoppable Recipes
      • Shoppable Products
      • Shoppable Media
    • Basic Setup
      • Basic Setup
      • Methods
      • Event Listeners
      • Widget
      • Subscriptions
      • Global Configuration
      • UTM Parameters
      • Using With SPA
  • Shopping List Mobile API
    • Overview
    • Examples
    • Reference
  • Tips and Tricks
    • Object IDs
    • URL Lookup
    • Searching
    • Multiple IDs request
  • Resources
    • Nutrients
    • Recipe Labels
    • Health Score, Glycemic Index, Glycemic Load
    • Whisk User Data
    • Supported Retailers
    • Optimizing Image Load
Powered by GitBook
On this page
  • Overview
  • Boosting
  • Combination of labels
  • Labels
  • Nutrition
  • Avoidances
  • Diets
  • Meal Types
  • Cuisines
  • Technique

Was this helpful?

  1. Resources

Recipe Labels

PreviousNutrientsNextHealth Score, Glycemic Index, Glycemic Load

Last updated 4 years ago

Was this helpful?

Overview

All Whisk recipes are classified with different types of labels. Labels represent different recipe attributes, you can use these labels to filter recipes. For example, to get some Lacto-Vegetarian friendly recipes from French or Italian cuisine for Lunch, this filter can be used:

labels=cuisine:french,cuisine:italian,diet:lacto-vegetarian,mealType:lunch

See below for a full list of available labels.

Boosting

Labels aren’t just for filtering recipes, they can also be used to sort recipes. You can use the boostsuffix to make recipes with this label appear more often in results.

For example, a user has lacto-vegetarian diet and wants to see more dinners:

labels=diet:lacto-vegetarian,mealType:dinner:boost

Combination of labels

The results of filtering and boosting depends on the combinations of label groups.

All labels groups are combined using ANDrelation, for example this query will return only British desserts:

labels=cuisine:british,mealType:desserts

Within label groups (when using multiple labels from one group) the relation depends on the label type:

Labels combined with AND:

Labels combined with OR:

For example, this query will return recipes which are British ORFrench withlow-fat ANDlow-sugars.

labels=cuisine:british,cuisine:french,nutrition:low-sugars,nutrition:low-fat

Labels

Nutrition

Nutrition labels are based on nutrition information of recipes such as Energy, Fat, Sugar amount.

General nutrition labels

  • nutrition:cholesterol-free

  • nutrition:diabetes-friendly

  • nutrition:fat-free

  • nutrition:healthy

  • nutrition:high-fiber

  • nutrition:high-monounsaturated-fat

  • nutrition:high-polyunsaturated-fat

  • nutrition:high-protein

  • nutrition:high-unsaturated-fat

  • nutrition:low-cholesterol

  • nutrition:low-carb

  • nutrition:low-energy

  • nutrition:low-fat

  • nutrition:low-salt

  • nutrition:low-saturated-fat

  • nutrition:low-sodium

  • nutrition:low-sugars

  • nutrition:salt-free

  • nutrition:saturated-fat-free

  • nutrition:sodium-free

  • nutrition:source-of-fiber

  • nutrition:source-of-protein

  • nutrition:sugars-free

  • nutrition:very-low-salt

  • nutrition:very-low-sodium

Minerals and vitamins

Also, Whisk provides nutrition labels for minerals and vitamins. Each recipe can be a Source Of or Highin any mineral or vitamin. You can build labels using the tokens below, for example:

nutrition:high-calcium or nutrition:source-of-vitamin-a.

minerals: calcium, magnesium, potassium, iron, zinc, phosphorus

vitamins: vitamin-a, vitamin-c, thiamin-b1, riboflavin-b2,niacin-b3, vitamin-b6, folic-acid-b9, vitamin-b12,vitamin-d, vitamin-e, vitamin-k

Avoidances

Avoidances are specific items that someone restricts from their diet. Use this parameter to return recipes that exclude one or more of the following avoidances.

  • avoidance:alcohol

  • avoidance:caffeine

  • avoidance:celery

  • avoidance:crustacean

  • avoidance:egg

  • avoidance:fish

  • avoidance:gluten

  • avoidance:groundnut

  • avoidance:milk

  • avoidance:mollusc

  • avoidance:mustard

  • avoidance:sesame

  • avoidance:soybean

  • avoidance:sulfites

  • avoidance:tree-nut

  • avoidance:wheat

  • avoidance:yeast

  • avoidance:lactose

Diets

Diets are a restriction of the types of food someone eats. Use this parameter to return recipes that supports one or more diets.

  • diet:lacto-vegetarian

  • diet:ovo-vegetarian

  • diet:pescatarian

  • diet:vegan

  • diet:vegetarian

  • diet:low-carb

  • diet:mediterranean

  • diet:ketogenic

  • diet:paleo

  • diet:detox

  • diet:dairy-free

Meal Types

Meal types are the classification of recipes based on variety of factors including: time of day consumed; preparation method, etc. Use this parameter to return recipes that are categorized as one or more of the following values.

  • mealType:aperitif

  • mealType:appetizers

  • mealType:beverages

  • mealType:breads

  • mealType:breakfast

  • mealType:brunch

  • mealType:cocktails

  • mealType:condiments-and-sauces

  • mealType:desserts

  • mealType:dinner

  • mealType:juices

  • mealType:lunch

  • mealType:main-course

  • mealType:salads

  • mealType:side-dishes

  • mealType:smoothies

  • mealType:snacks

  • mealType:soups-and-stews

Cuisines

A cuisine is a style of cooking characterized by distinctive ingredients, techniques, and dishes usually associated with a specific culture or geographic region.

  • cuisine:african

  • cuisine:american

  • cuisine:asian

  • cuisine:australian

  • cuisine:british

  • cuisine:cajun-and-creole

  • cuisine:canadian

  • cuisine:caribbean

  • cuisine:chinese

  • cuisine:cuban

  • cuisine:eastern-european

  • cuisine:european

  • cuisine:french

  • cuisine:german

  • cuisine:greek

  • cuisine:indian

  • cuisine:israeli

  • cuisine:italian

  • cuisine:japanese

  • cuisine:korean

  • cuisine:latin-american

  • cuisine:mediterranean

  • cuisine:mexican

  • cuisine:middle-eastern

  • cuisine:moroccan

  • cuisine:portuguese

  • cuisine:southern

  • cuisine:spanish

  • cuisine:tex-mex

  • cuisine:thai

  • cuisine:vietnamese

  • cuisine:world-cuisine

Technique

Techniques are a style or method of cooking. Use this parameter to return recipes categorized as one or more of the following techniques.

  • technique:baking

  • technique:barbecuing

  • technique:blanching

  • technique:blending

  • technique:boiling

  • technique:braising

  • technique:broiling

  • technique:browning

  • technique:chilling

  • technique:cooking

  • technique:deep-frying

  • technique:freezing

  • technique:frying

  • technique:grilling

  • technique:knife-skills

  • technique:marinating

  • technique:microwaving

  • technique:mixer

  • technique:parboiling

  • technique:pan-frying

  • technique:poaching

  • technique:pickling-and-preserving

  • technique:pressure-cooking

  • technique:roasting

  • technique:saute

  • technique:simmering

  • technique:shaking

  • technique:slow-cooking

  • technique:smoking

  • technique:stewing

  • technique:steaming

  • technique:stirring

  • technique:stir-frying

  • technique:toasting

  • technique:uncooked

  • technique:whisking

  • technique:wok-skills

Nutrition
Avoidances
Diets
Cuisines
Meal Types