# Recipe Labels

## 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:

```bash
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 `boost`suffix 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:

```bash
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 `AND`relation, for example this query will return only British desserts:

```bash
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:

* [Nutrition](#nutrition)
* [Avoidances](#avoidances)
* [Diets](#diets)

Labels combined with OR:

* [Cuisines](#cuisines)
* [Meal Types](#meal-types)

For example, this query will return recipes which are British `OR`French `with`low-fat `AND`low-sugars.

```bash
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 `High`in 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`