Search Recipes

GET {{baseUrl}}/recipes/complexSearch?query=burger&cuisine=italian&excludeCuisine=greek&diet=vegetarian&intolerances=gluten&equipment=pan&includeIngredients=tomato,cheese&excludeIngredients=eggs&type=main course&instructionsRequired=true&fillIngredients=false&addRecipeInformation=false&addRecipeNutrition=false&author=coffeebean&tags=occaecat aliqua Duis cupidatat tempor&recipeBoxId=2468&titleMatch=Crock Pot&maxReadyTime=20&ignorePantry=false&sort=calories&sortDirection=asc&minCarbs=10&maxCarbs=100&minProtein=10&maxProtein=100&minCalories=50&maxCalories=800&minFat=1&maxFat=100&minAlcohol=0&maxAlcohol=100&minCaffeine=0&maxCaffeine=100&minCopper=0&maxCopper=100&minCalcium=0&maxCalcium=100&minCholine=0&maxCholine=100&minCholesterol=0&maxCholesterol=100&minFluoride=0&maxFluoride=100&minSaturatedFat=0&maxSaturatedFat=100&minVitaminA=0&maxVitaminA=100&minVitaminC=0&maxVitaminC=100&minVitaminD=0&maxVitaminD=100&minVitaminE=0&maxVitaminE=100&minVitaminK=0&maxVitaminK=100&minVitaminB1=0&maxVitaminB1=100&minVitaminB2=0&maxVitaminB2=100&minVitaminB5=0&maxVitaminB5=100&minVitaminB3=0&maxVitaminB3=100&minVitaminB6=0&maxVitaminB6=100&minVitaminB12=0&maxVitaminB12=100&minFiber=0&maxFiber=100&minFolate=0&maxFolate=100&minFolicAcid=0&maxFolicAcid=100&minIodine=0&maxIodine=100&minIron=0&maxIron=100&minMagnesium=0&maxMagnesium=100&minManganese=0&maxManganese=100&minPhosphorus=0&maxPhosphorus=100&minPotassium=0&maxPotassium=100&minSelenium=0&maxSelenium=100&minSodium=0&maxSodium=100&minSugar=0&maxSugar=100&minZinc=0&maxZinc=100&offset=394&number=10&limitLicense=true

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.

Request Params

KeyDatatypeRequiredDescription
querystringThe (natural language) search query.
cuisinestringThe cuisine(s) of the recipes. One or more, comma separated (will be interpreted as 'OR'). See a full list of supported cuisines.
excludeCuisinestringThe cuisine(s) the recipes must not match. One or more, comma separated (will be interpreted as 'AND'). See a full list of supported cuisines.
dietstringThe diet for which the recipes must be suitable. See a full list of supported diets.
intolerancesstringA 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.
equipmentstringThe equipment required. Multiple values will be interpreted as 'or'. For example, value could be "blender, frying pan, bowl".
includeIngredientsstringA comma-separated list of ingredients that should/must be used in the recipes.
excludeIngredientsstringA comma-separated list of ingredients or ingredient types that the recipes must not contain.
typestringThe type of recipe. See a full list of supported meal types.
instructionsRequiredbooleanWhether the recipes must have instructions.
fillIngredientsbooleanAdd information about the ingredients and whether they are used or missing in relation to the query.
addRecipeInformationbooleanIf set to true, you get more information about the recipes returned.
addRecipeNutritionbooleanIf set to true, you get nutritional information about each recipes returned.
authorstringThe username of the recipe author.
tagsstringThe tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have.
recipeBoxIdnumberThe id of the recipe box to which the search should be limited to.
titleMatchstringEnter text that must be found in the title of the recipes.
maxReadyTimenumberThe maximum time in minutes it should take to prepare and cook the recipe.
ignorePantrybooleanWhether to ignore typical pantry items, such as water, salt, flour, etc.
sortstringThe strategy to sort recipes by. See a full list of supported sorting options.
sortDirectionstringThe direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending).
minCarbsnumberThe minimum amount of carbohydrates in grams the recipe must have.
maxCarbsnumberThe maximum amount of carbohydrates in grams the recipe can have.
minProteinnumberThe minimum amount of protein in grams the recipe must have.
maxProteinnumberThe maximum amount of protein in grams the recipe can have.
minCaloriesnumberThe minimum amount of calories the recipe must have.
maxCaloriesnumberThe maximum amount of calories the recipe can have.
minFatnumberThe minimum amount of fat in grams the recipe must have.
maxFatnumberThe maximum amount of fat in grams the recipe can have.
minAlcoholnumberThe minimum amount of alcohol in grams the recipe must have.
maxAlcoholnumberThe maximum amount of alcohol in grams the recipe can have.
minCaffeinenumberThe minimum amount of caffeine in milligrams the recipe must have.
maxCaffeinenumberThe maximum amount of caffeine in milligrams the recipe can have.
minCoppernumberThe minimum amount of copper in milligrams the recipe must have.
maxCoppernumberThe maximum amount of copper in milligrams the recipe can have.
minCalciumnumberThe minimum amount of calcium in milligrams the recipe must have.
maxCalciumnumberThe maximum amount of calcium in milligrams the recipe can have.
minCholinenumberThe minimum amount of choline in milligrams the recipe must have.
maxCholinenumberThe maximum amount of choline in milligrams the recipe can have.
minCholesterolnumberThe minimum amount of cholesterol in milligrams the recipe must have.
maxCholesterolnumberThe maximum amount of cholesterol in milligrams the recipe can have.
minFluoridenumberThe minimum amount of fluoride in milligrams the recipe must have.
maxFluoridenumberThe maximum amount of fluoride in milligrams the recipe can have.
minSaturatedFatnumberThe minimum amount of saturated fat in grams the recipe must have.
maxSaturatedFatnumberThe maximum amount of saturated fat in grams the recipe can have.
minVitaminAnumberThe minimum amount of Vitamin A in IU the recipe must have.
maxVitaminAnumberThe maximum amount of Vitamin A in IU the recipe can have.
minVitaminCnumberThe minimum amount of Vitamin C milligrams the recipe must have.
maxVitaminCnumberThe maximum amount of Vitamin C in milligrams the recipe can have.
minVitaminDnumberThe minimum amount of Vitamin D in micrograms the recipe must have.
maxVitaminDnumberThe maximum amount of Vitamin D in micrograms the recipe can have.
minVitaminEnumberThe minimum amount of Vitamin E in milligrams the recipe must have.
maxVitaminEnumberThe maximum amount of Vitamin E in milligrams the recipe can have.
minVitaminKnumberThe minimum amount of Vitamin K in micrograms the recipe must have.
maxVitaminKnumberThe maximum amount of Vitamin K in micrograms the recipe can have.
minVitaminB1numberThe minimum amount of Vitamin B1 in milligrams the recipe must have.
maxVitaminB1numberThe maximum amount of Vitamin B1 in milligrams the recipe can have.
minVitaminB2numberThe minimum amount of Vitamin B2 in milligrams the recipe must have.
maxVitaminB2numberThe maximum amount of Vitamin B2 in milligrams the recipe can have.
minVitaminB5numberThe minimum amount of Vitamin B5 in milligrams the recipe must have.
maxVitaminB5numberThe maximum amount of Vitamin B5 in milligrams the recipe can have.
minVitaminB3numberThe minimum amount of Vitamin B3 in milligrams the recipe must have.
maxVitaminB3numberThe maximum amount of Vitamin B3 in milligrams the recipe can have.
minVitaminB6numberThe minimum amount of Vitamin B6 in milligrams the recipe must have.
maxVitaminB6numberThe maximum amount of Vitamin B6 in milligrams the recipe can have.
minVitaminB12numberThe minimum amount of Vitamin B12 in micrograms the recipe must have.
maxVitaminB12numberThe maximum amount of Vitamin B12 in micrograms the recipe can have.
minFibernumberThe minimum amount of fiber in grams the recipe must have.
maxFibernumberThe maximum amount of fiber in grams the recipe can have.
minFolatenumberThe minimum amount of folate in micrograms the recipe must have.
maxFolatenumberThe maximum amount of folate in micrograms the recipe can have.
minFolicAcidnumberThe minimum amount of folic acid in micrograms the recipe must have.
maxFolicAcidnumberThe maximum amount of folic acid in micrograms the recipe can have.
minIodinenumberThe minimum amount of iodine in micrograms the recipe must have.
maxIodinenumberThe maximum amount of iodine in micrograms the recipe can have.
minIronnumberThe minimum amount of iron in milligrams the recipe must have.
maxIronnumberThe maximum amount of iron in milligrams the recipe can have.
minMagnesiumnumberThe minimum amount of magnesium in milligrams the recipe must have.
maxMagnesiumnumberThe maximum amount of magnesium in milligrams the recipe can have.
minManganesenumberThe minimum amount of manganese in milligrams the recipe must have.
maxManganesenumberThe maximum amount of manganese in milligrams the recipe can have.
minPhosphorusnumberThe minimum amount of phosphorus in milligrams the recipe must have.
maxPhosphorusnumberThe maximum amount of phosphorus in milligrams the recipe can have.
minPotassiumnumberThe minimum amount of potassium in milligrams the recipe must have.
maxPotassiumnumberThe maximum amount of potassium in milligrams the recipe can have.
minSeleniumnumberThe minimum amount of selenium in micrograms the recipe must have.
maxSeleniumnumberThe maximum amount of selenium in micrograms the recipe can have.
minSodiumnumberThe minimum amount of sodium in milligrams the recipe must have.
maxSodiumnumberThe maximum amount of sodium in milligrams the recipe can have.
minSugarnumberThe minimum amount of sugar in grams the recipe must have.
maxSugarnumberThe maximum amount of sugar in grams the recipe can have.
minZincnumberThe minimum amount of zinc in milligrams the recipe must have.
maxZincnumberThe maximum amount of zinc in milligrams the recipe can have.
offsetnumberThe number of results to skip (between 0 and 900).
numbernumberThe maximum number of items to return (between 1 and 100). Defaults to 10.
limitLicensebooleanWhether the recipes should have an open license that allows display with proper attribution.

RESPONSES

status: OK

{"offset":0,"number":2,"results":[{"id":716429,"title":"Pasta with Garlic, Scallions, Cauliflower \u0026 Breadcrumbs","calories":584,"carbs":"84g","fat":"20g","image":"https://spoonacular.com/recipeImages/716429-312x231.jpg","imageType":"jpg","protein":"19g"},{"id":715538,"title":"What to make for dinner tonight?? Bruschetta Style Pork \u0026 Pasta","calories":521,"carbs":"69g","fat":"10g","image":"https://spoonacular.com/recipeImages/715538-312x231.jpg","imageType":"jpg","protein":"35g"}],"totalResults":86}