Sign in

v1

latestOpenAPI 3.0.0spoonacular API Terms2026-07-139901.1 MB
recipes

Search Recipes

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.

get/recipes/complexSearch

Query parameters

querystring
Example:burger

The (natural language) search query.

cuisinestring
Example:italian

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

excludeCuisinestring
Example:greek

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.

dietstring
Example:vegetarian

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

intolerancesstring
Example:gluten

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.

equipmentstring
Example:pan

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

includeIngredientsstring
Example:tomato,cheese

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

excludeIngredientsstring
Example:eggs

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

typestring
Example:main course

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

instructionsRequiredboolean
Example:true

Whether the recipes must have instructions.

fillIngredientsboolean

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

addRecipeInformationboolean

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

addRecipeNutritionboolean

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

authorstring
Example:coffeebean

The username of the recipe author.

tagsstring

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

recipeBoxIdnumber
Example:2468

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

titleMatchstring
Example:Crock Pot

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

maxReadyTimenumber
Example:20

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

ignorePantryboolean

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

sortstring
Example:calories

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

sortDirectionstring
Example:asc

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

minCarbsnumber
Example:10

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

maxCarbsnumber
Example:100

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

minProteinnumber
Example:10

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

maxProteinnumber
Example:100

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

minCaloriesnumber
Example:50

The minimum amount of calories the recipe must have.

maxCaloriesnumber
Example:800

The maximum amount of calories the recipe can have.

minFatnumber
Example:1

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

maxFatnumber
Example:100

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

minAlcoholnumber

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

maxAlcoholnumber
Example:100

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

minCaffeinenumber

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

maxCaffeinenumber
Example:100

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

minCoppernumber

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

maxCoppernumber
Example:100

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

minCalciumnumber

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

maxCalciumnumber
Example:100

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

minCholinenumber

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

maxCholinenumber
Example:100

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

minCholesterolnumber

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

maxCholesterolnumber
Example:100

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

minFluoridenumber

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

maxFluoridenumber
Example:100

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

minSaturatedFatnumber

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

maxSaturatedFatnumber
Example:100

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

minVitaminAnumber

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

maxVitaminAnumber
Example:100

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

minVitaminCnumber

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

maxVitaminCnumber
Example:100

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

minVitaminDnumber

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

maxVitaminDnumber
Example:100

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

minVitaminEnumber

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

maxVitaminEnumber
Example:100

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

minVitaminKnumber

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

maxVitaminKnumber
Example:100

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

minVitaminB1number

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

maxVitaminB1number
Example:100

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

minVitaminB2number

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

maxVitaminB2number
Example:100

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

minVitaminB5number

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

maxVitaminB5number
Example:100

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

minVitaminB3number

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

maxVitaminB3number
Example:100

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

minVitaminB6number

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

maxVitaminB6number
Example:100

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

minVitaminB12number

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

maxVitaminB12number
Example:100

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

minFibernumber

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

maxFibernumber
Example:100

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

minFolatenumber

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

maxFolatenumber
Example:100

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

minFolicAcidnumber

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

maxFolicAcidnumber
Example:100

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

minIodinenumber

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

maxIodinenumber
Example:100

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

minIronnumber

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

maxIronnumber
Example:100

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

minMagnesiumnumber

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

maxMagnesiumnumber
Example:100

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

minManganesenumber

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

maxManganesenumber
Example:100

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

minPhosphorusnumber

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

maxPhosphorusnumber
Example:100

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

minPotassiumnumber

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

maxPotassiumnumber
Example:100

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

minSeleniumnumber

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

maxSeleniumnumber
Example:100

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

minSodiumnumber

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

maxSodiumnumber
Example:100

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

minSugarnumber

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

maxSugarnumber
Example:100

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

minZincnumber

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

maxZincnumber
Example:100

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

offsetinteger

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

numberinteger
Example:10

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

limitLicenseboolean
Example:true

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

Response

Success

offsetinteger required
numberinteger required
totalResultsinteger required
All 99 operations