---
title: "Search Recipes"
method: GET
path: "/recipes/complexSearch"
tags: ["recipes"]
---

# Search Recipes

`GET /recipes/complexSearch`

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.

## Query parameters

- `query` string
- `cuisine` string
- `excludeCuisine` string
- `diet` string
- `intolerances` string
- `equipment` string
- `includeIngredients` string
- `excludeIngredients` string
- `type` string
- `instructionsRequired` boolean
- `fillIngredients` boolean
- `addRecipeInformation` boolean
- `addRecipeNutrition` boolean
- `author` string
- `tags` string
- `recipeBoxId` number
- `titleMatch` string
- `maxReadyTime` number
- `ignorePantry` boolean
- `sort` string
- `sortDirection` string
- `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
- `limitLicense` boolean

## Response `200`

Success

- object
  - `offset` integer, required
  - `number` integer, required
  - `results` object[], required
    - `id` integer, required
    - `title` string, required
    - `calories` number, required
    - `carbs` string, required
    - `fat` string, required
    - `image` string, required
    - `imageType` string, required
    - `protein` string, required
  - `totalResults` integer, 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)