Search Recipes by Ingredients
GET {{baseUrl}}/recipes/findByIngredients?ingredients=carrots,tomatoes&number=10&limitLicense=true&ranking=1&ignorePantry=false
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).
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
ingredients | string | A comma-separated list of ingredients that the recipes should contain. | |
number | number | The maximum number of items to return (between 1 and 100). Defaults to 10. | |
limitLicense | boolean | Whether the recipes should have an open license that allows display with proper attribution. | |
ranking | number | Whether to maximize used ingredients (1) or minimize missing ingredients (2) first. | |
ignorePantry | boolean | Whether to ignore typical pantry items, such as water, salt, flour, etc. |
RESPONSES
status: OK
[{"id":73420,"image":"https://spoonacular.com/recipeImages/73420-312x231.jpg","imageType":"jpg","likes":0,"missedIngredientCount":3,"missedIngredients":[{"aisle":"Baking","amount":1,"id":18371,"image":"https://spoonacular.com/cdn/ingredients_100x100/white-powder.jpg","meta":[],"name":"baking powder","original":"1 tsp baking powder","originalName":"baking powder","unit":"tsp","unitLong":"teaspoon","unitShort":"tsp"},{"aisle":"Spices and Seasonings","amount":1,"id":2010,"image":"https://spoonacular.com/cdn/ingredients_100x100/cinnamon.jpg","meta":[],"name":"cinnamon","original":"1 tsp cinnamon","originalName":"cinnamon","unit":"tsp","unitLong":"teaspoon","unitShort":"tsp"},{"aisle":"Milk, Eggs, Other Dairy","amount":1,"id":1123,"image":"https://spoonacular.com/cdn/ingredients_100x100/egg.png","meta":[],"name":"egg","original":"1 egg","originalName":"egg","unit":"","unitLong":"","unitShort":""}],"title":"Apple Or Peach Strudel","unusedIngredients":[],"usedIngredientCount":1,"usedIngredients":[{"aisle":"Produce","amount":6,"id":9003,"image":"https://spoonacular.com/cdn/ingredients_100x100/apple.jpg","meta":[],"name":"apples","original":"6 large baking apples","originalName":"baking apples","unit":"large","unitLong":"larges","unitShort":"large"}]},{"id":632660,"image":"https://spoonacular.com/recipeImages/632660-312x231.jpg","imageType":"jpg","likes":3,"missedIngredientCount":4,"missedIngredients":[{"aisle":"Milk, Eggs, Other Dairy","amount":1.5,"extendedName":"unsalted butter","id":1001,"image":"https://spoonacular.com/cdn/ingredients_100x100/butter-sliced.jpg","meta":["unsalted","cold"],"name":"butter","original":"1 1/2 sticks cold unsalted butter cold unsalted butter\u003c","originalName":"cold unsalted butter cold unsalted butter\u003c","unit":"sticks","unitLong":"sticks","unitShort":"sticks"},{"aisle":"Produce","amount":4,"id":1079003,"image":"https://spoonacular.com/cdn/ingredients_100x100/red-delicious-apples.png","meta":["red"," such as golden delicious, peeled, cored and cut into 1/4-inch-thick slices "],"name":"red apples","original":"4 larges red apples, such as Golden Delicious, peeled, cored and cut into 1/4-inch-thick slices","originalName":"s red apples, such as Golden Delicious, peeled, cored and cut into 1/4-inch-thick slices","unit":"large","unitLong":"larges","unitShort":"large"},{"aisle":"Spices and Seasonings","amount":2,"id":2010,"image":"https://spoonacular.com/cdn/ingredients_100x100/cinnamon.jpg","meta":[],"name":"cinnamon","original":"2 teaspoons cinnamon","originalName":"cinnamon","unit":"teaspoons","unitLong":"teaspoons","unitShort":"tsp"},{"aisle":"Nut butters, Jams, and Honey","amount":2,"id":19719,"image":"https://spoonacular.com/cdn/ingredients_100x100/apricot-jam.jpg","meta":["melted"],"name":"apricot preserves","original":"2 tablespoons apricot preserves, melted and strained","originalName":"apricot preserves, melted and strained","unit":"tablespoons","unitLong":"tablespoons","unitShort":"Tbsp"}],"title":"Apricot Glazed Apple Tart","unusedIngredients":[{"aisle":"Produce","amount":1,"id":9003,"image":"https://spoonacular.com/cdn/ingredients_100x100/apple.jpg","meta":[],"name":"apples","original":"apples","originalName":"apples","unit":"serving","unitLong":"serving","unitShort":"serving"}],"usedIngredientCount":0,"usedIngredients":[]}]