# 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](/master/resources/recipe-labels.md#nutrition)
* [Avoidances](/master/resources/recipe-labels.md#avoidances)
* [Diets](/master/resources/recipe-labels.md#diets)

Labels combined with OR:

* [Cuisines](/master/resources/recipe-labels.md#cuisines)
* [Meal Types](/master/resources/recipe-labels.md#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`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whisk.com/master/resources/recipe-labels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
