---
title: "Search Recipes by Ingredients"
method: GET
path: "/recipes/findByIngredients"
tags: ["recipes"]
---

# Search Recipes by Ingredients

`GET /recipes/findByIngredients`

Ever wondered what recipes you can cook with the ingredients you have in your fridge or pantry? This endpoint lets you find recipes that either maximize the usage of ingredients you have at hand (pre shopping) or minimize the ingredients that you don't currently have (post shopping).

## Query parameters

- `ingredients` string
- `number` integer
- `limitLicense` boolean
- `ranking` number
- `ignorePantry` boolean

## Response `200`

Success

- object[]
  - `id` integer, required
  - `image` string, required
  - `imageType` string, required
  - `likes` integer, required
  - `missedIngredientCount` integer, required
  - `missedIngredients` object[], required
    - `aisle` string, required
    - `amount` number, required
    - `id` integer, required
    - `image` string, required
    - `meta` string[]
    - `name` string, required
    - `original` string, required
    - `originalName` string, required
    - `unit` string, required
    - `unitLong` string, required
    - `unitShort` string, required
  - `title` string, required
  - `unusedIngredients` object[], required
  - `usedIngredientCount` number, required
  - `usedIngredients` object[], required
    - `aisle` string, required
    - `amount` number, required
    - `id` integer, required
    - `image` string, required
    - `meta` string[]
    - `name` string, required
    - `original` string, required
    - `originalName` string, required
    - `unit` string, required
    - `unitLong` string, required
    - `unitShort` 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)