Search Recipes by Nutrients

GET {{baseUrl}}/recipes/findByNutrients?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&random=false&limitLicense=true

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.

Request Params

KeyDatatypeRequiredDescription
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 in 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.
randombooleanIf true, every request will give you a random set of recipes within the requested limits.
limitLicensebooleanWhether the recipes should have an open license that allows display with proper attribution.

RESPONSES

status: OK

[{"calories":210,"carbs":"43g","fat":"3g","id":90629,"image":"https://spoonacular.com/recipeImages/90629-312x231.jpg","imageType":"jpg","protein":"1g","title":"Baked Apples in White Wine"},{"calories":226,"carbs":"33g","fat":"10g","id":284420,"image":"https://spoonacular.com/recipeImages/284420-312x231.jpg","imageType":"jpg","protein":"2g","title":"Chocolate Silk Pie with Marshmallow Meringue"}]