v1

latestOpenAPI 3.0.0spoonacular API Terms2026-07-139901.1 MB

recipes

Search Recipes by Nutrients

Find a set of recipes that adhere to the given nutritional limits. You may set limits for macronutrients (calories, protein, fat, and carbohydrate) and/or many micronutrients.

get/recipes/findByNutrients

Query parameters

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 in 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.

randomboolean

If true, every request will give you a random set of recipes within the requested limits.

limitLicenseboolean

Example:true

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

Response

Success

caloriesnumber required

carbsstring required

fatstring required

idinteger required

imagestring required

imageTypestring required

proteinstring required

titlestring required