GET /recipes/complexSearch

spoonacular.com

Summary: Search Recipes
Operation ID: searchRecipes
Auth: unknown
Description

Search through hundreds of thousands of recipes using advanced filtering and ranking. NOTE: This method combines searching by query, by ingredients, and by nutrients into one endpoint.

Parameters (96)

addRecipeInformation (boolean, query, optional)

If set to true, you get more information about the recipes returned.

addRecipeNutrition (boolean, query, optional)

If set to true, you get nutritional information about each recipes returned.

author (string, query, optional)

The username of the recipe author.

cuisine (string, query, optional)

The cuisine(s) of the recipes. One or more, comma separated (will be interpreted as 'OR'). See a full list of supported cuisines.

diet (string, query, optional)

The diet for which the recipes must be suitable. See a full list of supported diets.

equipment (string, query, optional)

The equipment required. Multiple values will be interpreted as 'or'. For example, value could be "blender, frying pan, bowl".

excludeCuisine (string, query, optional)

The cuisine(s) the recipes must not match. One or more, comma separated (will be interpreted as 'AND'). See a full list of supported cuisines.

excludeIngredients (string, query, optional)

A comma-separated list of ingredients or ingredient types that the recipes must not contain.

fillIngredients (boolean, query, optional)

Add information about the ingredients and whether they are used or missing in relation to the query.

ignorePantry (boolean, query, optional, default: False)

Whether to ignore typical pantry items, such as water, salt, flour, etc.

includeIngredients (string, query, optional)

A comma-separated list of ingredients that should/must be used in the recipes.

instructionsRequired (boolean, query, optional)

Whether the recipes must have instructions.

intolerances (string, query, optional)

A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the intolerances entered. See a full list of supported intolerances.

limitLicense (boolean, query, optional, default: True)

Whether the recipes should have an open license that allows display with proper attribution.

maxAlcohol (number, query, optional)

The maximum amount of alcohol in grams the recipe can have.

maxCaffeine (number, query, optional)

The maximum amount of caffeine in milligrams the recipe can have.

maxCalcium (number, query, optional)

The maximum amount of calcium in milligrams the recipe can have.

maxCalories (number, query, optional)

The maximum amount of calories the recipe can have.

maxCarbs (number, query, optional)

The maximum amount of carbohydrates in grams the recipe can have.

maxCholesterol (number, query, optional)

The maximum amount of cholesterol in milligrams the recipe can have.

maxCholine (number, query, optional)

The maximum amount of choline in milligrams the recipe can have.

maxCopper (number, query, optional)

The maximum amount of copper in milligrams the recipe can have.

maxFat (number, query, optional)

The maximum amount of fat in grams the recipe can have.

maxFiber (number, query, optional)

The maximum amount of fiber in grams the recipe can have.

maxFluoride (number, query, optional)

The maximum amount of fluoride in milligrams the recipe can have.

maxFolate (number, query, optional)

The maximum amount of folate in micrograms the recipe can have.

maxFolicAcid (number, query, optional)

The maximum amount of folic acid in micrograms the recipe can have.

maxIodine (number, query, optional)

The maximum amount of iodine in micrograms the recipe can have.

maxIron (number, query, optional)

The maximum amount of iron in milligrams the recipe can have.

maxMagnesium (number, query, optional)

The maximum amount of magnesium in milligrams the recipe can have.

maxManganese (number, query, optional)

The maximum amount of manganese in milligrams the recipe can have.

maxPhosphorus (number, query, optional)

The maximum amount of phosphorus in milligrams the recipe can have.

maxPotassium (number, query, optional)

The maximum amount of potassium in milligrams the recipe can have.

maxProtein (number, query, optional)

The maximum amount of protein in grams the recipe can have.

maxReadyTime (number, query, optional)

The maximum time in minutes it should take to prepare and cook the recipe.

maxSaturatedFat (number, query, optional)

The maximum amount of saturated fat in grams the recipe can have.

maxSelenium (number, query, optional)

The maximum amount of selenium in micrograms the recipe can have.

maxSodium (number, query, optional)

The maximum amount of sodium in milligrams the recipe can have.

maxSugar (number, query, optional)

The maximum amount of sugar in grams the recipe can have.

maxVitaminA (number, query, optional)

The maximum amount of Vitamin A in IU the recipe can have.

maxVitaminB1 (number, query, optional)

The maximum amount of Vitamin B1 in milligrams the recipe can have.

maxVitaminB12 (number, query, optional)

The maximum amount of Vitamin B12 in micrograms the recipe can have.

maxVitaminB2 (number, query, optional)

The maximum amount of Vitamin B2 in milligrams the recipe can have.

maxVitaminB3 (number, query, optional)

The maximum amount of Vitamin B3 in milligrams the recipe can have.

maxVitaminB5 (number, query, optional)

The maximum amount of Vitamin B5 in milligrams the recipe can have.

maxVitaminB6 (number, query, optional)

The maximum amount of Vitamin B6 in milligrams the recipe can have.

maxVitaminC (number, query, optional)

The maximum amount of Vitamin C in milligrams the recipe can have.

maxVitaminD (number, query, optional)

The maximum amount of Vitamin D in micrograms the recipe can have.

maxVitaminE (number, query, optional)

The maximum amount of Vitamin E in milligrams the recipe can have.

maxVitaminK (number, query, optional)

The maximum amount of Vitamin K in micrograms the recipe can have.

maxZinc (number, query, optional)

The maximum amount of zinc in milligrams the recipe can have.

minAlcohol (number, query, optional)

The minimum amount of alcohol in grams the recipe must have.

minCaffeine (number, query, optional)

The minimum amount of caffeine in milligrams the recipe must have.

minCalcium (number, query, optional)

The minimum amount of calcium in milligrams the recipe must have.

minCalories (number, query, optional)

The minimum amount of calories the recipe must have.

minCarbs (number, query, optional)

The minimum amount of carbohydrates in grams the recipe must have.

minCholesterol (number, query, optional)

The minimum amount of cholesterol in milligrams the recipe must have.

minCholine (number, query, optional)

The minimum amount of choline in milligrams the recipe must have.

minCopper (number, query, optional)

The minimum amount of copper in milligrams the recipe must have.

minFat (number, query, optional)

The minimum amount of fat in grams the recipe must have.

minFiber (number, query, optional)

The minimum amount of fiber in grams the recipe must have.

minFluoride (number, query, optional)

The minimum amount of fluoride in milligrams the recipe must have.

minFolate (number, query, optional)

The minimum amount of folate in micrograms the recipe must have.

minFolicAcid (number, query, optional)

The minimum amount of folic acid in micrograms the recipe must have.

minIodine (number, query, optional)

The minimum amount of iodine in micrograms the recipe must have.

minIron (number, query, optional)

The minimum amount of iron in milligrams the recipe must have.

minMagnesium (number, query, optional)

The minimum amount of magnesium in milligrams the recipe must have.

minManganese (number, query, optional)

The minimum amount of manganese in milligrams the recipe must have.

minPhosphorus (number, query, optional)

The minimum amount of phosphorus in milligrams the recipe must have.

minPotassium (number, query, optional)

The minimum amount of potassium in milligrams the recipe must have.

minProtein (number, query, optional)

The minimum amount of protein in grams the recipe must have.

minSaturatedFat (number, query, optional)

The minimum amount of saturated fat in grams the recipe must have.

minSelenium (number, query, optional)

The minimum amount of selenium in micrograms the recipe must have.

minSodium (number, query, optional)

The minimum amount of sodium in milligrams the recipe must have.

minSugar (number, query, optional)

The minimum amount of sugar in grams the recipe must have.

minVitaminA (number, query, optional)

The minimum amount of Vitamin A in IU the recipe must have.

minVitaminB1 (number, query, optional)

The minimum amount of Vitamin B1 in milligrams the recipe must have.

minVitaminB12 (number, query, optional)

The minimum amount of Vitamin B12 in micrograms the recipe must have.

minVitaminB2 (number, query, optional)

The minimum amount of Vitamin B2 in milligrams the recipe must have.

minVitaminB3 (number, query, optional)

The minimum amount of Vitamin B3 in milligrams the recipe must have.

minVitaminB5 (number, query, optional)

The minimum amount of Vitamin B5 in milligrams the recipe must have.

minVitaminB6 (number, query, optional)

The minimum amount of Vitamin B6 in milligrams the recipe must have.

minVitaminC (number, query, optional)

The minimum amount of Vitamin C milligrams the recipe must have.

minVitaminD (number, query, optional)

The minimum amount of Vitamin D in micrograms the recipe must have.

minVitaminE (number, query, optional)

The minimum amount of Vitamin E in milligrams the recipe must have.

minVitaminK (number, query, optional)

The minimum amount of Vitamin K in micrograms the recipe must have.

minZinc (number, query, optional)

The minimum amount of zinc in milligrams the recipe must have.

number (integer, query, optional, default: 10)

The maximum number of items to return (between 1 and 100). Defaults to 10.

Constraints: {'minimum': 1, 'maximum': 100}

offset (integer, query, optional)

The number of results to skip (between 0 and 900).

Constraints: {'minimum': 0, 'maximum': 900}

query (string, query, optional)

The (natural language) search query.

recipeBoxId (number, query, optional)

The id of the recipe box to which the search should be limited to.

sort (string, query, optional)

The strategy to sort recipes by. See a full list of supported sorting options.

sortDirection (string, query, optional)

The direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending).

tags (string, query, optional)

The tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have.

titleMatch (string, query, optional)

Enter text that must be found in the title of the recipes.

type (string, query, optional)

The type of recipe. See a full list of supported meal types.

No probe data for this endpoint yet.