---
title: "Search Recipes by Nutrients"
method: GET
path: "/recipes/findByNutrients"
tags: ["recipes"]
---

# Search Recipes by Nutrients

`GET /recipes/findByNutrients`

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.

## Query parameters

- `minCarbs` number
- `maxCarbs` number
- `minProtein` number
- `maxProtein` number
- `minCalories` number
- `maxCalories` number
- `minFat` number
- `maxFat` number
- `minAlcohol` number
- `maxAlcohol` number
- `minCaffeine` number
- `maxCaffeine` number
- `minCopper` number
- `maxCopper` number
- `minCalcium` number
- `maxCalcium` number
- `minCholine` number
- `maxCholine` number
- `minCholesterol` number
- `maxCholesterol` number
- `minFluoride` number
- `maxFluoride` number
- `minSaturatedFat` number
- `maxSaturatedFat` number
- `minVitaminA` number
- `maxVitaminA` number
- `minVitaminC` number
- `maxVitaminC` number
- `minVitaminD` number
- `maxVitaminD` number
- `minVitaminE` number
- `maxVitaminE` number
- `minVitaminK` number
- `maxVitaminK` number
- `minVitaminB1` number
- `maxVitaminB1` number
- `minVitaminB2` number
- `maxVitaminB2` number
- `minVitaminB5` number
- `maxVitaminB5` number
- `minVitaminB3` number
- `maxVitaminB3` number
- `minVitaminB6` number
- `maxVitaminB6` number
- `minVitaminB12` number
- `maxVitaminB12` number
- `minFiber` number
- `maxFiber` number
- `minFolate` number
- `maxFolate` number
- `minFolicAcid` number
- `maxFolicAcid` number
- `minIodine` number
- `maxIodine` number
- `minIron` number
- `maxIron` number
- `minMagnesium` number
- `maxMagnesium` number
- `minManganese` number
- `maxManganese` number
- `minPhosphorus` number
- `maxPhosphorus` number
- `minPotassium` number
- `maxPotassium` number
- `minSelenium` number
- `maxSelenium` number
- `minSodium` number
- `maxSodium` number
- `minSugar` number
- `maxSugar` number
- `minZinc` number
- `maxZinc` number
- `offset` integer
- `number` integer
- `random` boolean
- `limitLicense` boolean

## Response `200`

Success

- object[]
  - `calories` number, required
  - `carbs` string, required
  - `fat` string, required
  - `id` integer, required
  - `image` string, required
  - `imageType` string, required
  - `protein` string, required
  - `title` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/spoonacular/apis/spoonacular-api.md) · [All operations](https://skmtc.net/spoonacular/apis/spoonacular-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spoonacular/spoonacular-api/versions/bc2fbe4e8981/schema)