# Spoonacular
> Cook with Spoonacular's food API: search 365,000 recipes by ingredients, diet, cuisine or nutrients, get a recipe's ingredients, method, nutrition and price, read recipes from web pages, parse and convert ingredient lines, look up grocery products by barcode and chain restaurant menu items, plan meals, build shopping lists and pair wines. Needs a Spoonacular API key; the free plan has 50 points a day.
App · Food & Drink · 41 actions. Web page: https://docs.lodol.com/docs/integrations/spoonacular
## Actions
### Analyze a recipe
Analyze your own recipe from its title, servings, ingredient lines and method: Spoonacular reads each ingredient and works out the recipe's diets, dish types, cuisines, price, scores and method step by step, and optionally its nutrition and taste. Costs 1 point, plus 0.5 each for nutrition and taste.
**Inputs**
- Title (`title`, text, required): The recipe's name, such as Spaghetti Carbonara.
- Servings (`servings`, number, required): How many it serves. At least 1.
- Ingredients (`ingredients`, list, required): The ingredient lines, one a line, such as 1 lb spaghetti.
- Method (`instructions`, text): Optional. How to make it, as text.
- Language (`language`, text): Optional. The language the text is in. English when left empty. One of: `en` (English), `de` (German).
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste (`include_taste`, true/false): Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
**Outputs**: A recipe.
- `cheap` (true/false): True if it is cheap to make.
- `cooking_minutes` (number): Minutes of cooking.
- `credits_text` (text): Who to credit when showing it.
- `cuisines` (list): Its cuisines, such as italian.
- `dairy_free` (true/false): True if it is dairy free.
- `diets` (list): The diets it suits, such as gluten free.
- `dish_types` (list): What kind of dish it is, such as main course.
- `gaps` (text): Whether it suits the GAPS diet: no, or a stage.
- `gluten_free` (true/false): True if it is gluten free.
- `health_score` (number): Spoonacular's health score, from 0 to 100.
- `id` (number): The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type, such as jpg.
- `ingredients` (list): Its ingredients.
- `instructions` (text): Its method, as published.
- `ketogenic` (true/false): True if it is ketogenic.
- `license` (text): Its license, such as CC BY 3.0.
- `likes` (number): How many people liked it.
- `low_fodmap` (true/false): True if it is low FODMAP.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `occasions` (list): Occasions it suits, such as christmas.
- `preparation_minutes` (number): Minutes of preparation.
- `price_per_serving_cents` (number): What a serving costs, in US cents.
- `ready_in_minutes` (number): Minutes from start to table.
- `servings` (number): How many it serves.
- `source_name` (text): Who published it.
- `source_url` (text): Where it was published.
- `spoonacular_score` (number): Spoonacular's overall score, from 0 to 100.
- `spoonacular_url` (text): Its page on spoonacular.com.
- `steps` (list): Its method, step by step.
- `summary` (text): A summary of it, in HTML.
- `summary_text` (text): The summary as plain text.
- `sustainable` (true/false): True if it is sustainable.
- `taste` (object): The recipe's taste, each from 0 to 100. Null unless it was asked for.
- `title` (text): Its name.
- `vegan` (true/false): True if it is vegan.
- `vegetarian` (true/false): True if it is vegetarian.
- `very_healthy` (true/false): True if it is very healthy.
- `very_popular` (true/false): True if it is very popular.
- `weight_watcher_smart_points` (number): Its Weight Watchers SmartPoints.
- `whole30` (true/false): True if it is Whole30.
- `wine_pairing` (object): Wines that go with the recipe. Null unless it was asked for.
**Example output**
```json
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-556x370.jpg",
"image_type": "jpg",
"ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": "solid",
"extended_name": null,
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
},
"us": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
}
},
"meta": [],
"name": "butter",
"name_clean": null,
"original": "1 tbsp butter",
"original_name": "butter",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Produce",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 10011135,
"image": "https://img.spoonacular.com/ingredients_100x100/cauliflower.jpg",
"measures": {
"metric": {
"amount": 473.176,
"unit_long": "milliliters",
"unit_short": "ml"
},
"us": {
"amount": 2.0,
"unit_long": "cups",
"unit_short": "cups"
}
},
"meta": [
"frozen",
"thawed",
"cut into bite-sized pieces"
],
"name": "cauliflower florets",
"name_clean": null,
"original": "about 2 cups frozen cauliflower florets, thawed, cut into bite-sized pieces",
"original_name": "about frozen cauliflower florets, thawed, cut into bite-sized pieces",
"unit": "cups",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Cheese",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 1041009,
"image": "https://img.spoonacular.com/ingredients_100x100/cheddar-cheese.png",
"measures": {
"metric": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
},
"us": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
}
},
"meta": [
"grated",
"(I used romano)"
],
"name": "cheese",
"name_clean": null,
"original": "2 tbsp grated cheese (I used romano)",
"original_name": "grated cheese (I used romano)",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
}
],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": {
"paired_wines": [
"chardonnay",
"gruener veltliner",
"sauvignon blanc"
],
"pairing_text": "Chardonnay, Gruener Veltliner, and Sauvignon Blanc are great choices for Pasta. Sauvignon Blanc and Gruner Veltliner both have herby notes that complement salads with enough acid to match tart vinaigrettes, while a Chardonnay can be a good pick for creamy salad dressings. The Buddha Kat Winery Chardonnay with a 4 out of 5 star rating seems like a good match. It costs about 25 dollars per bottle.",
"product_matches": [
{
"average_rating": 0.8,
"description": "We barrel ferment our Chardonnay and age it in a mix of Oak and Stainless. Giving this light bodied wine modest oak character, a delicate floral aroma, and a warming finish.",
"id": 469199,
"image": "https://img.spoonacular.com/products/469199-312x231.jpg",
"link": "https://www.amazon.com/2015-Buddha-Kat-Winery-Chardonnay/dp/B00OSAVVM4?tag=spoonacular-20",
"price": "$25.0",
"price_usd": 25.0,
"rating_count": 1.0,
"score": 0.55,
"title": "Buddha Kat Winery Chardonnay"
}
]
}
}
```
### Answer a nutrition question
Answer a food or nutrition question asked in plain words, such as How much vitamin C is in 2 apples?
**Inputs**
- Question (`question`, text, required): The question, such as How much vitamin C is in 2 apples?
**Outputs**
- `answer` (text): The answer.
- `image` (text): A link to a picture of the food it is about.
**Example output**
```json
{
"answer": "There are 16.74 mg of Vitamin C in 2 apples. This covers about 20% of your daily needs of Vitamin C.",
"image": "https://img.spoonacular.com/ingredients_100x100/apple.jpg"
}
```
### Autocomplete ingredient names
Suggest ingredients whose names complete what someone has started typing, such as appl. Costs 0.1 points.
**Inputs**
- Search (`query`, text, required): The text to complete, such as appl.
- Add aisle and units (`meta_information`, true/false): Optional. Add each one's ID, supermarket aisle and units.
- Intolerances (`intolerances`, text): Optional. Leave out anything unsuitable for these intolerances. Spoonacular reads ingredients automatically, so it cannot be right every time: it is not medical advice. One or more of: `dairy`, `egg`, `gluten`, `grain`, `peanut`, `seafood`, `sesame`, `shellfish`, `soy`, `sulfite`, `tree nut`, `wheat`.
- Language (`language`, text): Optional. The language the text is in. English when left empty. One of: `en` (English), `de` (German).
- How many (`number`, number): Optional. How many suggestions to return, from 1 to 100. 10 when left empty. From 1 to 100.
**Outputs**
- `count` (number): How many came back.
- `suggestions` (list): The ingredients whose names fit.
**Example output**
```json
{
"count": 3,
"suggestions": [
{
"aisle": "Produce",
"id": 9003,
"image": "https://img.spoonacular.com/ingredients_100x100/apple.jpg",
"name": "apple",
"possible_units": [
"small",
"large",
"piece"
]
},
{
"aisle": "Canned and Jarred",
"id": 9019,
"image": "https://img.spoonacular.com/ingredients_100x100/applesauce.png",
"name": "applesauce",
"possible_units": [
"g",
"oz",
"cup"
]
},
{
"aisle": "Beverages",
"id": 9016,
"image": "https://img.spoonacular.com/ingredients_100x100/apple-juice.jpg",
"name": "apple juice",
"possible_units": [
"g",
"drink box",
"fl oz"
]
}
]
}
```
### Autocomplete menu item names
Suggest menu items whose names complete what someone has started typing, such as chicke. Costs 0.1 points.
**Inputs**
- Search (`query`, text, required): The text to complete, such as chicke.
- How many (`number`, number): Optional. How many suggestions to return, from 1 to 25. 10 when left empty. From 1 to 25.
**Outputs**
- `count` (number): How many came back.
- `suggestions` (list): The menu items whose names fit.
**Example output**
```json
{
"count": 2,
"suggestions": [
{
"id": 253419,
"title": "pei wei asian diner thai chicken lettuce wraps"
},
{
"id": 380722,
"title": "camille's chicken caesar salad includes 2 oz. caesar dressing"
}
]
}
```
### Autocomplete product names
Suggest grocery products whose names complete what someone has started typing, such as chicke. Costs 0.1 points.
**Inputs**
- Search (`query`, text, required): The text to complete, such as chicke.
- How many (`number`, number): Optional. How many suggestions to return, from 1 to 25. 10 when left empty. From 1 to 25.
**Outputs**
- `count` (number): How many came back.
- `suggestions` (list): The products whose names fit.
**Example output**
```json
{
"count": 2,
"suggestions": [
{
"id": 208698,
"title": "buddig premium deli chicken breast - rotisserie flavored"
},
{
"id": 41291,
"title": "tyson all natural chicken breasts tenderloins"
}
]
}
```
### Autocomplete recipe names
Suggest recipe names that complete what someone has started typing, such as chick. Costs 0.1 points.
**Inputs**
- Search (`query`, text, required): The text to complete, such as chick.
- How many (`number`, number): Optional. How many suggestions to return, from 1 to 25. 10 when left empty. From 1 to 25.
**Outputs**
- `count` (number): How many came back.
- `suggestions` (list): The recipes whose names fit.
**Example output**
```json
{
"count": 3,
"suggestions": [
{
"id": 296687,
"image": "https://img.spoonacular.com/recipes/296687-556x370.jpg",
"image_type": "jpg",
"title": "chicken"
},
{
"id": 42569,
"image": "https://img.spoonacular.com/recipes/42569-556x370.jpg",
"image_type": "jpg",
"title": "chicken bbq"
},
{
"id": 83890,
"image": "https://img.spoonacular.com/recipes/83890-556x370.jpg",
"image_type": "jpg",
"title": "chicken blt"
}
]
}
```
### Classify a grocery product
Match a packaged product's name to a basic food category, such as Kroger Vitamin A & D Reduced Fat 2% Milk to 2 percent milk, with its USDA code. Costs 0.5 points.
**Inputs**
- Product name (`title`, text, required): The product's name as on the pack or a receipt, such as Kroger Vitamin A & D Reduced Fat 2% Milk.
- UPC (`upc`, text): Optional. Its barcode number (UPC).
- PLU code (`plu_code`, text): Optional. Its produce code (PLU), for loose produce.
- Category names in (`locale`, text): Optional. Name categories in American or British English. American when left empty. One of: `en_US` (American English), `en_GB` (British English).
**Outputs**
- `breadcrumbs` (list): The category and the broader ones it is in.
- `category` (text): Its category, such as 2 percent milk.
- `clean_title` (text): The product's name, tidied.
- `image` (text): A link to a picture of the category.
- `usda_code` (number): The category's USDA food code.
**Example output**
```json
{
"breadcrumbs": [
"2 percent milk",
"milk",
"drink"
],
"category": "2 percent milk",
"clean_title": "Kroger Vitamin A & D Reduced Fat 2% Milk",
"image": "https://img.spoonacular.com/ingredients_100x100/milk.png",
"usda_code": 1174
}
```
### Classify a recipe's cuisine
Work out a recipe's cuisine, such as Mediterranean, from its title and ingredients. Costs 0.1 points.
**Inputs**
- Title (`title`, text, required): The recipe's name, such as Pork roast with green beans.
- Ingredients (`ingredients`, list): Optional. Its ingredient lines, one a line.
- Language (`language`, text): Optional. The language the text is in. English when left empty. One of: `en` (English), `de` (German).
**Outputs**
- `confidence` (number): How sure Spoonacular is, from 0 to 1.
- `cuisine` (text): The likeliest cuisine.
- `cuisines` (list): It and the broader cuisines it belongs to.
**Example output**
```json
{
"confidence": 0.0,
"cuisine": "Mediterranean",
"cuisines": [
"Mediterranean",
"European",
"Italian"
]
}
```
### Compute a shopping list
Turn a list of things to buy, such as 4 lbs tomatoes and 10 tomatoes, into a shopping list: like items added up, sorted by supermarket aisle, with amounts in metric and US units and costs.
**Inputs**
- Items (`items`, list, required): What to buy, one a line, such as 4 lbs tomatoes. The ingredients' original lines from Get a recipe work too. Up to 100.
**Outputs**
- `aisles` (list): The list by supermarket aisle.
- `cost_cents` (number): What it all costs, in US cents.
- `count` (number): How many came back.
- `items` (list): Everything to buy, aisle by aisle.
**Example output**
```json
{
"aisles": [
{
"aisle": "Pantry Items",
"items": [
{
"aisle": "Pantry Items",
"cost_cents": 333.55,
"ingredient_id": 4053,
"measures": {
"metric": {
"amount": 364.0,
"unit": "ml"
},
"us": {
"amount": 12.4,
"unit": "fl oz"
}
},
"name": "olive oil",
"pantry_item": true
}
]
},
{
"aisle": "Produce",
"items": [
{
"aisle": "Produce",
"cost_cents": 532.21,
"ingredient_id": 11529,
"measures": {
"metric": {
"amount": 3044.4,
"unit": "g"
},
"us": {
"amount": 6.8,
"unit": "lb"
}
},
"name": "tomatoes",
"pantry_item": false
}
]
}
],
"cost_cents": 1326.62,
"count": 2,
"items": [
{
"aisle": "Pantry Items",
"cost_cents": 333.55,
"ingredient_id": 4053,
"measures": {
"metric": {
"amount": 364.0,
"unit": "ml"
},
"us": {
"amount": 12.4,
"unit": "fl oz"
}
},
"name": "olive oil",
"pantry_item": true
},
{
"aisle": "Produce",
"cost_cents": 532.21,
"ingredient_id": 11529,
"measures": {
"metric": {
"amount": 3044.4,
"unit": "g"
},
"us": {
"amount": 6.8,
"unit": "lb"
}
},
"name": "tomatoes",
"pantry_item": false
}
]
}
```
### Convert an amount
Convert an amount of an ingredient between units, such as 2.5 cups of flour to grams. Converting between volume and weight takes the ingredient into account.
**Inputs**
- Ingredient (`ingredient`, text, required): The ingredient, such as flour.
- Amount (`source_amount`, number, required): How much, such as 2.5. At least 0.
- From unit (`source_unit`, text, required): The amount's unit, such as cups.
- To unit (`target_unit`, text, required): The unit to convert to, such as grams, or piece for a count.
**Outputs**
- `answer` (text): The conversion as a sentence.
- `source_amount` (number): The amount given.
- `source_unit` (text): Its unit.
- `target_amount` (number): The amount, converted.
- `target_unit` (text): The unit converted to.
**Example output**
```json
{
"answer": "2.5 cups flour translates to 312.5 grams.",
"source_amount": 2.5,
"source_unit": "cups",
"target_amount": 312.5,
"target_unit": "grams"
}
```
### Describe a wine
Describe a kind of wine in a sentence, such as Merlot is a dry red wine which is smooth and medium bodied.
**Inputs**
- Wine (`wine`, text, required): The kind of wine, such as merlot, riesling or malbec, or a family such as dry red wine. Pick one from the list or type it.
**Outputs**
- `description` (text): The description.
- `wine` (text): The wine, as Spoonacular names it.
**Example output**
```json
{
"description": "Merlot is a dry red wine which is smooth and medium bodied.",
"wine": "merlot"
}
```
### Estimate nutrition by dish name
Estimate the calories, protein, fat and carbohydrates of a dish from its name alone, such as Spaghetti Aglio et Olio, with a 95% confidence range for each.
**Inputs**
- Dish (`dish`, text, required): The dish's name, such as Spaghetti Aglio et Olio.
**Outputs**
- `calories` (object): An estimate.
- `carbs` (object): An estimate.
- `fat` (object): An estimate.
- `protein` (object): An estimate.
- `recipes_used` (number): How many recipes the estimate is made from.
**Example output**
```json
{
"calories": {
"max_95": 574.07,
"min_95": 389.92,
"standard_deviation": 148.55,
"unit": "calories",
"value": 428.0
},
"carbs": {
"max_95": 78.19,
"min_95": 55.54,
"standard_deviation": 18.27,
"unit": "g",
"value": 65.0
},
"fat": {
"max_95": 19.2,
"min_95": 12.27,
"standard_deviation": 5.59,
"unit": "g",
"value": 16.0
},
"protein": {
"max_95": 29.31,
"min_95": 8.12,
"standard_deviation": 17.09,
"unit": "g",
"value": 13.0
},
"recipes_used": 10
}
```
### Extract a recipe from a web page
Read the recipe on a web page (its title, ingredients, method, servings and time) into a recipe like Get a recipe's, to save or analyze. Can also read a recipe video on TikTok, YouTube, Instagram, Facebook or Pinterest. Costs 1 point, plus 1 to analyze, 1 to force a fresh read and 50 points for a video.
**Inputs**
- Page address (`url`, text, required): The address of the recipe's page, starting with https://. Not a spoonacular.com page, which Spoonacular refuses: Get a recipe reads those.
- Analyze (`analyze`, true/false): Optional. Also work out its cuisines, dish types, diets and more, for a point.
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste (`include_taste`, true/false): Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
- Read it fresh (`force_extraction`, true/false): Optional. Read the page again even if Spoonacular already knows the recipe, for a point. Slower; use it only if something is missing.
- Extract from a video (`extract_from_video`, true/false): Optional. For a video address, watch the video for the recipe. Costs 50 points (the free plan's whole day) and can take 30 seconds.
**Outputs**: A recipe.
- `cheap` (true/false): True if it is cheap to make.
- `cooking_minutes` (number): Minutes of cooking.
- `credits_text` (text): Who to credit when showing it.
- `cuisines` (list): Its cuisines, such as italian.
- `dairy_free` (true/false): True if it is dairy free.
- `diets` (list): The diets it suits, such as gluten free.
- `dish_types` (list): What kind of dish it is, such as main course.
- `gaps` (text): Whether it suits the GAPS diet: no, or a stage.
- `gluten_free` (true/false): True if it is gluten free.
- `health_score` (number): Spoonacular's health score, from 0 to 100.
- `id` (number): The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type, such as jpg.
- `ingredients` (list): Its ingredients.
- `instructions` (text): Its method, as published.
- `ketogenic` (true/false): True if it is ketogenic.
- `license` (text): Its license, such as CC BY 3.0.
- `likes` (number): How many people liked it.
- `low_fodmap` (true/false): True if it is low FODMAP.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `occasions` (list): Occasions it suits, such as christmas.
- `preparation_minutes` (number): Minutes of preparation.
- `price_per_serving_cents` (number): What a serving costs, in US cents.
- `ready_in_minutes` (number): Minutes from start to table.
- `servings` (number): How many it serves.
- `source_name` (text): Who published it.
- `source_url` (text): Where it was published.
- `spoonacular_score` (number): Spoonacular's overall score, from 0 to 100.
- `spoonacular_url` (text): Its page on spoonacular.com.
- `steps` (list): Its method, step by step.
- `summary` (text): A summary of it, in HTML.
- `summary_text` (text): The summary as plain text.
- `sustainable` (true/false): True if it is sustainable.
- `taste` (object): The recipe's taste, each from 0 to 100. Null unless it was asked for.
- `title` (text): Its name.
- `vegan` (true/false): True if it is vegan.
- `vegetarian` (true/false): True if it is vegetarian.
- `very_healthy` (true/false): True if it is very healthy.
- `very_popular` (true/false): True if it is very popular.
- `weight_watcher_smart_points` (number): Its Weight Watchers SmartPoints.
- `whole30` (true/false): True if it is Whole30.
- `wine_pairing` (object): Wines that go with the recipe. Null unless it was asked for.
**Example output**
```json
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-556x370.jpg",
"image_type": "jpg",
"ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": "solid",
"extended_name": null,
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
},
"us": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
}
},
"meta": [],
"name": "butter",
"name_clean": null,
"original": "1 tbsp butter",
"original_name": "butter",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Produce",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 10011135,
"image": "https://img.spoonacular.com/ingredients_100x100/cauliflower.jpg",
"measures": {
"metric": {
"amount": 473.176,
"unit_long": "milliliters",
"unit_short": "ml"
},
"us": {
"amount": 2.0,
"unit_long": "cups",
"unit_short": "cups"
}
},
"meta": [
"frozen",
"thawed",
"cut into bite-sized pieces"
],
"name": "cauliflower florets",
"name_clean": null,
"original": "about 2 cups frozen cauliflower florets, thawed, cut into bite-sized pieces",
"original_name": "about frozen cauliflower florets, thawed, cut into bite-sized pieces",
"unit": "cups",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Cheese",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 1041009,
"image": "https://img.spoonacular.com/ingredients_100x100/cheddar-cheese.png",
"measures": {
"metric": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
},
"us": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
}
},
"meta": [
"grated",
"(I used romano)"
],
"name": "cheese",
"name_clean": null,
"original": "2 tbsp grated cheese (I used romano)",
"original_name": "grated cheese (I used romano)",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
}
],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": {
"paired_wines": [
"chardonnay",
"gruener veltliner",
"sauvignon blanc"
],
"pairing_text": "Chardonnay, Gruener Veltliner, and Sauvignon Blanc are great choices for Pasta. Sauvignon Blanc and Gruner Veltliner both have herby notes that complement salads with enough acid to match tart vinaigrettes, while a Chardonnay can be a good pick for creamy salad dressings. The Buddha Kat Winery Chardonnay with a 4 out of 5 star rating seems like a good match. It costs about 25 dollars per bottle.",
"product_matches": [
{
"average_rating": 0.8,
"description": "We barrel ferment our Chardonnay and age it in a mix of Oak and Stainless. Giving this light bodied wine modest oak character, a delicate floral aroma, and a warming finish.",
"id": 469199,
"image": "https://img.spoonacular.com/products/469199-312x231.jpg",
"link": "https://www.amazon.com/2015-Buddha-Kat-Winery-Chardonnay/dp/B00OSAVVM4?tag=spoonacular-20",
"price": "$25.0",
"price_usd": 25.0,
"rating_count": 1.0,
"score": 0.55,
"title": "Buddha Kat Winery Chardonnay"
}
]
}
}
```
### Find foods in text
Find every dish and ingredient mentioned in a piece of text, such as a message or a review, each tagged dish or ingredient.
**Inputs**
- Text (`text`, text, required): The text to look through.
**Outputs**
- `annotations` (list): Each food found, in the order mentioned.
- `count` (number): How many came back.
- `dishes` (list): The dishes found, once each.
- `ingredients` (list): The ingredients found, once each.
**Example output**
```json
{
"annotations": [
{
"annotation": "cheeseburger",
"image": "https://spoonacular.com/menuItemImages/cheeseburger.jpg",
"tag": "dish"
},
{
"annotation": "mushrooms",
"image": "https://img.spoonacular.com/ingredients_100x100/mushrooms.png",
"tag": "ingredient"
},
{
"annotation": "pepperoni",
"image": "https://img.spoonacular.com/ingredients_100x100/pepperoni.png",
"tag": "ingredient"
}
],
"count": 3,
"dishes": [
"cheeseburger"
],
"ingredients": [
"mushrooms",
"pepperoni"
]
}
```
### Find recipes by ingredients
Find recipes to make with the ingredients you have: each with which of them it uses and which other ingredients it needs. Costs 1 point plus 0.01 a recipe.
**Inputs**
- Ingredients (`ingredients`, list, required): The ingredients to cook with, separated by commas, such as apples, flour, sugar.
- Rank by (`ranking`, text): Optional. Whether to use as many of the ingredients as possible, or to need as few others as possible. The first when left empty. One of: `maximize_used` (Use as many of the ingredients as possible), `minimize_missing` (Need as few other ingredients as possible).
- Ignore pantry staples (`ignore_pantry`, true/false): Optional. Take water, salt, flour and other staples as at hand. On when left empty. Default: `true`.
- How many (`number`, number): Optional. How many recipes to return, from 1 to 100. 10 when left empty. From 1 to 100.
**Outputs**
- `count` (number): How many came back.
- `recipes` (list): The recipes found, the best use of the ingredients first.
**Example output**
```json
{
"count": 2,
"recipes": [
{
"id": 73420,
"image": "https://img.spoonacular.com/recipes/73420-312x231.jpg",
"image_type": "jpg",
"likes": 0,
"missed_ingredient_count": 3,
"missed_ingredients": [
{
"aisle": "Baking",
"amount": 1.0,
"consistency": null,
"extended_name": null,
"id": 18371,
"image": "https://img.spoonacular.com/ingredients_100x100/white-powder.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "baking powder",
"name_clean": null,
"original": "1 tsp baking powder",
"original_name": "baking powder",
"unit": "tsp",
"unit_long": "teaspoon",
"unit_short": "tsp"
},
{
"aisle": "Spices and Seasonings",
"amount": 1.0,
"consistency": null,
"extended_name": null,
"id": 2010,
"image": "https://img.spoonacular.com/ingredients_100x100/cinnamon.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "cinnamon",
"name_clean": null,
"original": "1 tsp cinnamon",
"original_name": "cinnamon",
"unit": "tsp",
"unit_long": "teaspoon",
"unit_short": "tsp"
},
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": null,
"extended_name": null,
"id": 1123,
"image": "https://img.spoonacular.com/ingredients_100x100/egg.png",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "egg",
"name_clean": null,
"original": "1 egg",
"original_name": "egg",
"unit": null,
"unit_long": null,
"unit_short": null
}
],
"title": "Apple Or Peach Strudel",
"unused_ingredients": [],
"used_ingredient_count": 1,
"used_ingredients": [
{
"aisle": "Produce",
"amount": 6.0,
"consistency": null,
"extended_name": null,
"id": 9003,
"image": "https://img.spoonacular.com/ingredients_100x100/apple.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "apples",
"name_clean": null,
"original": "6 large baking apples",
"original_name": "baking apples",
"unit": "large",
"unit_long": "larges",
"unit_short": "large"
}
]
},
{
"id": 632660,
"image": "https://img.spoonacular.com/recipes/632660-312x231.jpg",
"image_type": "jpg",
"likes": 3,
"missed_ingredient_count": 4,
"missed_ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.5,
"consistency": null,
"extended_name": "unsalted butter",
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [
"unsalted",
"cold"
],
"name": "butter",
"name_clean": null,
"original": "1 1/2 sticks cold unsalted butter cold unsalted butter<",
"original_name": "cold unsalted butter cold unsalted butter<",
"unit": "sticks",
"unit_long": "sticks",
"unit_short": "sticks"
},
{
"aisle": "Produce",
"amount": 4.0,
"consistency": null,
"extended_name": null,
"id": 1079003,
"image": "https://img.spoonacular.com/ingredients_100x100/red-delicious-apples.png",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [
"red",
"such as golden delicious, peeled, cored and cut into 1/4-inch-thick slices"
],
"name": "red apples",
"name_clean": null,
"original": "4 larges red apples, such as Golden Delicious, peeled, cored and cut into 1/4-inch-thick slices",
"original_name": "s red apples, such as Golden Delicious, peeled, cored and cut into 1/4-inch-thick slices",
"unit": "large",
"unit_long": "larges",
"unit_short": "large"
},
{
"aisle": "Spices and Seasonings",
"amount": 2.0,
"consistency": null,
"extended_name": null,
"id": 2010,
"image": "https://img.spoonacular.com/ingredients_100x100/cinnamon.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "cinnamon",
"name_clean": null,
"original": "2 teaspoons cinnamon",
"original_name": "cinnamon",
"unit": "teaspoons",
"unit_long": "teaspoons",
"unit_short": "tsp"
}
],
"title": "Apricot Glazed Apple Tart",
"unused_ingredients": [
{
"aisle": "Produce",
"amount": 1.0,
"consistency": null,
"extended_name": null,
"id": 9003,
"image": "https://img.spoonacular.com/ingredients_100x100/apple.jpg",
"measures": {
"metric": {
"amount": null,
"unit_long": null,
"unit_short": null
},
"us": {
"amount": null,
"unit_long": null,
"unit_short": null
}
},
"meta": [],
"name": "apples",
"name_clean": null,
"original": "apples",
"original_name": "apples",
"unit": "serving",
"unit_long": "serving",
"unit_short": "serving"
}
],
"used_ingredient_count": 0,
"used_ingredients": []
}
]
}
```
### Find recipes by nutrients
Find recipes within nutrient limits per serving, such as under 500 calories with at least 30 g of protein, each with its calories, protein, fat and every limited nutrient. Spoonacular's search answers 0 g of carbohydrates for every recipe, so a 0 is left out; Get a recipe has the real figure. Costs 1 point plus 0.01 a recipe.
**Inputs**
- Minimum calories (`min_calories`, number): Optional. The least calories a serving may have. At least 0.
- Maximum calories (`max_calories`, number): Optional. The most calories a serving may have. At least 0.
- Minimum protein (`min_protein`, number): Optional. The least grams of protein a serving may have. At least 0.
- Maximum protein (`max_protein`, number): Optional. The most grams of protein a serving may have. At least 0.
- Minimum carbohydrates (`min_carbs`, number): Optional. The least grams of carbohydrates a serving may have. At least 0.
- Maximum carbohydrates (`max_carbs`, number): Optional. The most grams of carbohydrates a serving may have. At least 0.
- Minimum fat (`min_fat`, number): Optional. The least grams of fat a serving may have. At least 0.
- Maximum fat (`max_fat`, number): Optional. The most grams of fat a serving may have. At least 0.
- More nutrient limits (`nutrient_limits`, object): Optional. Limits on any other nutrient per serving, each a name and a number: min or max with the nutrient, such as minFiber 5, maxSodium 500, minVitaminC 30 or maxSugar 10. Spoonacular limits SaturatedFat, Sugar, Fiber, Cholesterol, Sodium, Alcohol, Caffeine, Calcium, Choline, Copper, Fluoride, Folate, FolicAcid, Iodine, Iron, Magnesium, Manganese, Phosphorus, Potassium, Selenium, Zinc and Vitamins A, B1, B2, B3, B5, B6, B12, C, D, E and K.
- Random (`random`, true/false): Optional. A different random set of matching recipes each time.
- How many (`number`, number): Optional. How many recipes to return, from 1 to 100. 10 when left empty. From 1 to 100.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 900. From 0 to 900.
**Outputs**
- `count` (number): How many came back.
- `recipes` (list): The recipes within the limits.
**Example output**
```json
{
"count": 3,
"recipes": [
{
"calories": 374,
"carbs_g": null,
"fat_g": 14,
"id": 636392,
"image": "https://img.spoonacular.com/recipes/636392-312x231.jpg",
"image_type": "jpg",
"nutrients": [
{
"amount": 374,
"name": "Calories",
"unit": "kcal"
},
{
"amount": 13,
"name": "Protein",
"unit": "g"
},
{
"amount": 14,
"name": "Fat",
"unit": "g"
}
],
"protein_g": 13,
"title": "Buckwheat Crepes"
},
{
"calories": 307,
"carbs_g": null,
"fat_g": 18,
"id": 641974,
"image": "https://img.spoonacular.com/recipes/641974-312x231.jpg",
"image_type": "jpg",
"nutrients": [
{
"amount": 307,
"name": "Calories",
"unit": "kcal"
},
{
"amount": 17,
"name": "Protein",
"unit": "g"
},
{
"amount": 18,
"name": "Fat",
"unit": "g"
}
],
"protein_g": 17,
"title": "Easy Gift Lasagna"
},
{
"calories": 248,
"carbs_g": null,
"fat_g": 18,
"id": 665019,
"image": "https://img.spoonacular.com/recipes/665019-312x231.jpg",
"image_type": "jpg",
"nutrients": [
{
"amount": 248,
"name": "Calories",
"unit": "kcal"
},
{
"amount": 5,
"name": "Protein",
"unit": "g"
},
{
"amount": 18,
"name": "Fat",
"unit": "g"
}
],
"protein_g": 5,
"title": "Watermelon Leaf Lettuce Salad With Light Feta"
}
]
}
```
### Generate a meal plan
Plan breakfast, lunch and dinner for a day or a week, close to a daily calorie target, for a diet and without what you leave out, with each day's calories, protein, fat and carbohydrates.
**Inputs**
- For (`time_frame`, text): Optional. A day or a whole week. A day when left empty. One of: `day` (One day), `week` (A whole week).
- Calories a day (`target_calories`, number): Optional. The calories to aim for each day, such as 2000. At least 1.
- Diet (`diet`, text): Optional. A diet every meal must suit. One of: `gluten free`, `ketogenic`, `vegetarian`, `lacto-vegetarian`, `ovo-vegetarian`, `vegan`, `pescetarian`, `paleo`, `primal`, `low fodmap`, `whole30`.
- Leave out (`exclude`, list): Optional. Allergens or ingredients to leave out, separated by commas, such as shellfish, olives.
**Outputs**
- `count` (number): How many meals the plan has.
- `days` (list): Each day of the plan.
- `meals` (list): Every meal of the plan, in order.
- `time_frame` (text): day or week.
**Example output**
```json
{
"count": 3,
"days": [
{
"day": null,
"meals": [
{
"id": 655219,
"image": "https://img.spoonacular.com/recipes/655219-556x370.jpg",
"image_type": "jpg",
"meal": "breakfast",
"ready_in_minutes": 45,
"servings": 1,
"source_url": "https://spoonacular.com/recipes/peanut-butter-and-chocolate-oatmeal-655219",
"title": "Peanut Butter And Chocolate Oatmeal"
},
{
"id": 649931,
"image": "https://img.spoonacular.com/recipes/649931-556x370.jpg",
"image_type": "jpg",
"meal": "lunch",
"ready_in_minutes": 45,
"servings": 4,
"source_url": "https://spoonacular.com/recipes/lentil-salad-with-vegetables-649931",
"title": "Lentil Salad With Vegetables"
},
{
"id": 632854,
"image": "https://img.spoonacular.com/recipes/632854-556x370.jpg",
"image_type": "jpg",
"meal": "dinner",
"ready_in_minutes": 45,
"servings": 4,
"source_url": "https://spoonacular.com/recipes/asian-noodles-632854",
"title": "Asian Noodles"
}
],
"nutrients": {
"calories": 1735.81,
"carbohydrates_g": 235.17,
"fat_g": 69.22,
"protein_g": 55.43
}
}
],
"meals": [
{
"day": null,
"id": 655219,
"image": "https://img.spoonacular.com/recipes/655219-556x370.jpg",
"image_type": "jpg",
"meal": "breakfast",
"ready_in_minutes": 45,
"servings": 1,
"source_url": "https://spoonacular.com/recipes/peanut-butter-and-chocolate-oatmeal-655219",
"title": "Peanut Butter And Chocolate Oatmeal"
},
{
"day": null,
"id": 649931,
"image": "https://img.spoonacular.com/recipes/649931-556x370.jpg",
"image_type": "jpg",
"meal": "lunch",
"ready_in_minutes": 45,
"servings": 4,
"source_url": "https://spoonacular.com/recipes/lentil-salad-with-vegetables-649931",
"title": "Lentil Salad With Vegetables"
},
{
"day": null,
"id": 632854,
"image": "https://img.spoonacular.com/recipes/632854-556x370.jpg",
"image_type": "jpg",
"meal": "dinner",
"ready_in_minutes": 45,
"servings": 4,
"source_url": "https://spoonacular.com/recipes/asian-noodles-632854",
"title": "Asian Noodles"
}
],
"time_frame": "day"
}
```
### Get a grocery product
Get a packaged product by ID: its ingredients, badges (such as gluten free), nutrition per serving, servings, price and aisle.
**Inputs**
- Product ID (`product_id`, text, required): The product's Spoonacular ID, such as 22347. Search grocery products returns it.
**Outputs**: A packaged grocery product. A search fills in the details only when asked to; Get a grocery product always does.
- `aisle` (text): The supermarket aisle it is found in.
- `badges` (list): Its badges, such as gluten_free or no_artificial_colors.
- `breadcrumbs` (list): Its categories, narrowest first.
- `credits` (object): Who to credit for the data, when Spoonacular says.
- `generated_text` (text): Spoonacular's description of it.
- `id` (number): The product's ID.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type.
- `important_badges` (list): The badges that matter most.
- `ingredient_count` (number): How many ingredients it has.
- `ingredient_list` (text): Its ingredients, as on the pack.
- `ingredients` (list): Its ingredients.
- `likes` (number): How many people liked it.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `price_cents` (number): Its price, in US cents; null when Spoonacular has none.
- `servings` (object): Its servings.
- `spoonacular_score` (number): Spoonacular's score for it, from 0 to 100.
- `title` (text): Its name.
- `upc` (text): Its barcode (UPC), when known.
**Example output**
```json
{
"aisle": "Sweet Snacks",
"badges": [
"msg_free",
"no_artificial_colors",
"no_artificial_flavors"
],
"breadcrumbs": [
"bars"
],
"credits": null,
"generated_text": null,
"id": 22347,
"image": "https://img.spoonacular.com/products/22347-312x231.jpg",
"image_type": "jpg",
"important_badges": [
"no_artificial_flavors",
"no_artificial_colors",
"no_artificial_ingredients"
],
"ingredient_count": 32,
"ingredient_list": "Snickers Brand Almond Bar: Milk Chocolate (Sugar, Cocoa Butter, Chocolate, Skim Milk, Lactose, Milkfat, Soy Lecithin, Artificial Flavor), Corn Syrup, Almonds, Sugar, Milkfat, Skim Milk, Less than 2% - Lactose, Salt, Hydrogenated Palm Kernel Oil and/or Palm Oil, Egg Whites, Chocolate, Artificial Flavor. Snickers Brand: Milk Chocolate (Sugar, Cocoa Butter, Chocolate, Skim Milk, Lactose, Milkfat, Soy Lecithin, Artificial Flavor), Peanuts, Corn Syrup, Sugar, Milkfat, Skim Milk, Partially Hydrogenated Soybean Oil, Lactose, Salt, Egg Whites, Chocolate, Artificial Flavor. Snickers Brand Peanut Butter Squared Bars: Milk Chocolate (Sugar, Cocoa Butter, Chocolate, Skim Milk, Lactose, Milkfat, Soy Lecithin, Artificial Flavor), Peanut Butter (Peanuts, Partially Hydrogenated Soybean Oil), Peanuts, Sugar, Corn Syrup, Vegetable Oil (Hydrogenated Palm Kernel Oil, Palm Oil, Rapeseed Oil and Cottonseed Oil and/or Partially Hydrogenated Palm Kernel Oil), Lactose, Corn Syrup Solids, Invert Sugar, Less than 2% - Glycerin, Dextrose, Skim Milk, Salt, Calcium Carbonate, Partially Hydrogenated Soybean Oil, Egg Whites, Artificial Flavor, TBHQ to Maintain Freshness",
"ingredients": [
{
"description": null,
"name": "emulsifier",
"safety_level": null
},
{
"description": null,
"name": "added sugar",
"safety_level": null
},
{
"description": null,
"name": "sweetener",
"safety_level": null
}
],
"likes": 0,
"nutrition": {
"caloric_breakdown": {
"percent_carbs": 57.78,
"percent_fat": 20,
"percent_protein": 22.22
},
"calories": 200,
"carbohydrates_g": 26,
"cholesterol_mg": null,
"fat_g": 4,
"fiber_g": null,
"flavonoids": [],
"ingredients": [],
"net_carbohydrates_g": null,
"nutrients": [
{
"amount": 4,
"name": "Fat",
"percent_of_daily_needs": 6.15,
"unit": "g"
},
{
"amount": 10,
"name": "Protein",
"percent_of_daily_needs": 20,
"unit": "g"
},
{
"amount": 200,
"name": "Calories",
"percent_of_daily_needs": 10,
"unit": "cal"
},
{
"amount": 26,
"name": "Carbohydrates",
"percent_of_daily_needs": 9.45,
"unit": "g"
}
],
"properties": [],
"protein_g": 10,
"saturated_fat_g": null,
"sodium_mg": null,
"sugar_g": null,
"weight_per_serving": {
"amount": null,
"unit": null
}
},
"price_cents": 324.0,
"servings": {
"number": 8,
"size": 4,
"unit": "pieces"
},
"spoonacular_score": 0.0,
"title": "SNICKERS Minis Size Chocolate Candy Bars Variety Mix 10.5-oz. Bag",
"upc": null
}
```
### Get a menu item
Get a restaurant chain's menu item by ID: its chain, nutrition per serving, servings and badges.
**Inputs**
- Menu item ID (`menu_item_id`, text, required): The menu item's Spoonacular ID, such as 424571. Search menu items returns it.
**Outputs**: A dish on a restaurant chain's menu. A search fills in the details only when asked to; Get a menu item always does.
- `badges` (list): Its badges.
- `breadcrumbs` (list): Its categories, narrowest first.
- `generated_text` (text): Spoonacular's description of it.
- `id` (number): The menu item's ID.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type.
- `likes` (number): How many people liked it.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `price` (number): Its price, when Spoonacular knows it.
- `restaurant_chain` (text): The chain, such as Burger King.
- `servings` (object): Its servings.
- `spoonacular_score` (number): Spoonacular's score for it, from 0 to 100.
- `title` (text): Its name.
**Example output**
```json
{
"badges": [],
"breadcrumbs": [
"burger",
"main course",
"food product category"
],
"generated_text": null,
"id": 424571,
"image": "https://img.spoonacular.com/menu-items/424571-312x231.png",
"image_type": "png",
"likes": 0,
"nutrition": {
"caloric_breakdown": {
"percent_carbs": 35,
"percent_fat": 30,
"percent_protein": 35
},
"calories": 1040,
"carbohydrates_g": 48,
"cholesterol_mg": null,
"fat_g": 69,
"fiber_g": null,
"flavonoids": [],
"ingredients": [],
"net_carbohydrates_g": null,
"nutrients": [
{
"amount": 69,
"name": "Fat",
"percent_of_daily_needs": 30,
"unit": "g"
},
{
"amount": 57,
"name": "Protein",
"percent_of_daily_needs": 35,
"unit": "g"
},
{
"amount": 1040,
"name": "Calories",
"percent_of_daily_needs": 50,
"unit": "cal"
},
{
"amount": 48,
"name": "Carbohydrates",
"percent_of_daily_needs": 35,
"unit": "g"
}
],
"properties": [],
"protein_g": 57,
"saturated_fat_g": null,
"sodium_mg": null,
"sugar_g": null,
"weight_per_serving": {
"amount": null,
"unit": null
}
},
"price": null,
"restaurant_chain": "Burger King",
"servings": {
"number": 1,
"size": 2,
"unit": "oz"
},
"spoonacular_score": null,
"title": "Bacon King Burger"
}
```
### Get a product by UPC
Look up a packaged product by its barcode (UPC): its ingredients, badges, nutrition per serving, servings, price and aisle.
**Inputs**
- UPC (`upc`, text, required): The product's barcode number (UPC), such as 041631000564. Spoonacular knows mostly products sold in the US.
**Outputs**: A packaged grocery product. A search fills in the details only when asked to; Get a grocery product always does.
- `aisle` (text): The supermarket aisle it is found in.
- `badges` (list): Its badges, such as gluten_free or no_artificial_colors.
- `breadcrumbs` (list): Its categories, narrowest first.
- `credits` (object): Who to credit for the data, when Spoonacular says.
- `generated_text` (text): Spoonacular's description of it.
- `id` (number): The product's ID.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type.
- `important_badges` (list): The badges that matter most.
- `ingredient_count` (number): How many ingredients it has.
- `ingredient_list` (text): Its ingredients, as on the pack.
- `ingredients` (list): Its ingredients.
- `likes` (number): How many people liked it.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `price_cents` (number): Its price, in US cents; null when Spoonacular has none.
- `servings` (object): Its servings.
- `spoonacular_score` (number): Spoonacular's score for it, from 0 to 100.
- `title` (text): Its name.
- `upc` (text): Its barcode (UPC), when known.
**Example output**
```json
{
"aisle": null,
"badges": [
"egg_free",
"wheat_free",
"grain_free"
],
"breadcrumbs": [
"flour"
],
"credits": {
"image": "openfoodfacts.org under CC BY-SA 3.0 DEED",
"image_link": "https://creativecommons.org/licenses/by-sa/3.0/deed.en",
"link": "https://opendatacommons.org/licenses/odbl/1-0/",
"text": "openfoodtacts.org under (ODbL) v1.0"
},
"generated_text": "Swan Flour: This product is an awesome fit if you are searching for a healthy flour. This product has 1 ingredient (in our experience: the fewer ingredients, the better!) This product contains no ingredients that some research suggests you should avoid. One serving of this product provides 30 calories, 0g grams of fat, 0g grams of protein, and 8g grams of carbs.",
"id": 30004,
"image": "https://img.spoonacular.com/products/30004-312x231.jpg",
"image_type": "jpg",
"important_badges": [
"gluten_free",
"paleo",
"primal"
],
"ingredient_count": null,
"ingredient_list": "Potato Starch",
"ingredients": [
{
"description": null,
"name": "starch",
"safety_level": null
},
{
"description": null,
"name": "potato starch",
"safety_level": null
}
],
"likes": 0,
"nutrition": {
"caloric_breakdown": {
"percent_carbs": 57.78,
"percent_fat": 20,
"percent_protein": 22.22
},
"calories": 30,
"carbohydrates_g": 8,
"cholesterol_mg": null,
"fat_g": 0,
"fiber_g": null,
"flavonoids": [],
"ingredients": [],
"net_carbohydrates_g": null,
"nutrients": [
{
"amount": 0,
"name": "Fat",
"percent_of_daily_needs": 0,
"unit": "g"
},
{
"amount": 0,
"name": "Protein",
"percent_of_daily_needs": 0,
"unit": "g"
},
{
"amount": 30,
"name": "Calories",
"percent_of_daily_needs": 10,
"unit": "cal"
},
{
"amount": 8,
"name": "Carbohydrates",
"percent_of_daily_needs": 9.45,
"unit": "g"
}
],
"properties": [],
"protein_g": 0,
"saturated_fat_g": null,
"sodium_mg": null,
"sugar_g": null,
"weight_per_serving": {
"amount": null,
"unit": null
}
},
"price_cents": null,
"servings": {
"number": 34,
"size": 1,
"unit": "tbsp"
},
"spoonacular_score": 99.0,
"title": "Swan Flour",
"upc": "041631000564"
}
```
### Get a random food joke
Get a random joke about food. Spoonacular warns that some are for adults.
**Inputs**: None.
**Outputs**
- `text` (text): The joke.
**Example output**
```json
{
"text": "Any salad can be a Caesar salad if you stab it enough."
}
```
### Get a recipe
Get a recipe by ID: its ingredients with amounts in metric and US units, method step by step, time, servings, diets, scores, price per serving, summary and source, and optionally its nutrition, taste and a wine pairing. Costs 1 point, plus 0.1 for nutrition, 0.5 for taste and 1 for a wine pairing.
**Inputs**
- Recipe ID (`recipe_id`, text, required): The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste (`include_taste`, true/false): Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
- Include a wine pairing (`include_wine_pairing`, true/false): Optional. Add wines that go with it, and bottles on sale.
**Outputs**: A recipe.
- `cheap` (true/false): True if it is cheap to make.
- `cooking_minutes` (number): Minutes of cooking.
- `credits_text` (text): Who to credit when showing it.
- `cuisines` (list): Its cuisines, such as italian.
- `dairy_free` (true/false): True if it is dairy free.
- `diets` (list): The diets it suits, such as gluten free.
- `dish_types` (list): What kind of dish it is, such as main course.
- `gaps` (text): Whether it suits the GAPS diet: no, or a stage.
- `gluten_free` (true/false): True if it is gluten free.
- `health_score` (number): Spoonacular's health score, from 0 to 100.
- `id` (number): The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
- `image` (text): A link to its picture.
- `image_type` (text): The picture's file type, such as jpg.
- `ingredients` (list): Its ingredients.
- `instructions` (text): Its method, as published.
- `ketogenic` (true/false): True if it is ketogenic.
- `license` (text): Its license, such as CC BY 3.0.
- `likes` (number): How many people liked it.
- `low_fodmap` (true/false): True if it is low FODMAP.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `occasions` (list): Occasions it suits, such as christmas.
- `preparation_minutes` (number): Minutes of preparation.
- `price_per_serving_cents` (number): What a serving costs, in US cents.
- `ready_in_minutes` (number): Minutes from start to table.
- `servings` (number): How many it serves.
- `source_name` (text): Who published it.
- `source_url` (text): Where it was published.
- `spoonacular_score` (number): Spoonacular's overall score, from 0 to 100.
- `spoonacular_url` (text): Its page on spoonacular.com.
- `steps` (list): Its method, step by step.
- `summary` (text): A summary of it, in HTML.
- `summary_text` (text): The summary as plain text.
- `sustainable` (true/false): True if it is sustainable.
- `taste` (object): The recipe's taste, each from 0 to 100. Null unless it was asked for.
- `title` (text): Its name.
- `vegan` (true/false): True if it is vegan.
- `vegetarian` (true/false): True if it is vegetarian.
- `very_healthy` (true/false): True if it is very healthy.
- `very_popular` (true/false): True if it is very popular.
- `weight_watcher_smart_points` (number): Its Weight Watchers SmartPoints.
- `whole30` (true/false): True if it is Whole30.
- `wine_pairing` (object): Wines that go with the recipe. Null unless it was asked for.
**Example output**
```json
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-556x370.jpg",
"image_type": "jpg",
"ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": "solid",
"extended_name": null,
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
},
"us": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
}
},
"meta": [],
"name": "butter",
"name_clean": null,
"original": "1 tbsp butter",
"original_name": "butter",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Produce",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 10011135,
"image": "https://img.spoonacular.com/ingredients_100x100/cauliflower.jpg",
"measures": {
"metric": {
"amount": 473.176,
"unit_long": "milliliters",
"unit_short": "ml"
},
"us": {
"amount": 2.0,
"unit_long": "cups",
"unit_short": "cups"
}
},
"meta": [
"frozen",
"thawed",
"cut into bite-sized pieces"
],
"name": "cauliflower florets",
"name_clean": null,
"original": "about 2 cups frozen cauliflower florets, thawed, cut into bite-sized pieces",
"original_name": "about frozen cauliflower florets, thawed, cut into bite-sized pieces",
"unit": "cups",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Cheese",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 1041009,
"image": "https://img.spoonacular.com/ingredients_100x100/cheddar-cheese.png",
"measures": {
"metric": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
},
"us": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
}
},
"meta": [
"grated",
"(I used romano)"
],
"name": "cheese",
"name_clean": null,
"original": "2 tbsp grated cheese (I used romano)",
"original_name": "grated cheese (I used romano)",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
}
],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": {
"paired_wines": [
"chardonnay",
"gruener veltliner",
"sauvignon blanc"
],
"pairing_text": "Chardonnay, Gruener Veltliner, and Sauvignon Blanc are great choices for Pasta. Sauvignon Blanc and Gruner Veltliner both have herby notes that complement salads with enough acid to match tart vinaigrettes, while a Chardonnay can be a good pick for creamy salad dressings. The Buddha Kat Winery Chardonnay with a 4 out of 5 star rating seems like a good match. It costs about 25 dollars per bottle.",
"product_matches": [
{
"average_rating": 0.8,
"description": "We barrel ferment our Chardonnay and age it in a mix of Oak and Stainless. Giving this light bodied wine modest oak character, a delicate floral aroma, and a warming finish.",
"id": 469199,
"image": "https://img.spoonacular.com/products/469199-312x231.jpg",
"link": "https://www.amazon.com/2015-Buddha-Kat-Winery-Chardonnay/dp/B00OSAVVM4?tag=spoonacular-20",
"price": "$25.0",
"price_usd": 25.0,
"rating_count": 1.0,
"score": 0.55,
"title": "Buddha Kat Winery Chardonnay"
}
]
}
}
```
### Get a recipe's price breakdown
Get what a recipe costs to make, ingredient by ingredient, with the total and the cost a serving, in US cents.
**Inputs**
- Recipe ID (`recipe_id`, text, required): The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
**Outputs**
- `count` (number): How many came back.
- `ingredients` (list): Each ingredient's cost.
- `total_cost_cents` (number): What the whole recipe costs, in US cents.
- `total_cost_per_serving_cents` (number): What a serving costs, in US cents.
**Example output**
```json
{
"count": 3,
"ingredients": [
{
"amount": {
"metric": {
"unit": "g",
"value": 222.0
},
"us": {
"unit": "cups",
"value": 1.5
}
},
"image": "https://img.spoonacular.com/ingredients_100x100/blueberries.jpg",
"name": "blueberries",
"price_cents": 174.43
},
{
"amount": {
"metric": {
"unit": null,
"value": 1.0
},
"us": {
"unit": null,
"value": 1.0
}
},
"image": "https://img.spoonacular.com/ingredients_100x100/egg-white.jpg",
"name": "egg white",
"price_cents": 18.21
},
{
"amount": {
"metric": {
"unit": "Tbsps",
"value": 2.0
},
"us": {
"unit": "Tbsps",
"value": 2.0
}
},
"image": "https://img.spoonacular.com/ingredients_100x100/flour.png",
"name": "flour",
"price_cents": 2.0
}
],
"total_cost_cents": 832.45,
"total_cost_per_serving_cents": 104.06
}
```
### Get a wine pairing
Find wines that go with a food (a dish such as steak, an ingredient such as salmon, or a cuisine such as italian), why they do, and a bottle on sale.
**Inputs**
- Food (`food`, text, required): A dish, an ingredient or a cuisine, such as steak, salmon or italian.
- Maximum price (`max_price`, number): Optional. The most a recommended bottle may cost, in US dollars. At least 1.
**Outputs**
- `paired_wines` (list): The kinds of wine that go with it, such as merlot.
- `pairing_text` (text): Why those wines go with it.
- `product_matches` (list): Wines on sale of the first kind.
**Example output**
```json
{
"paired_wines": [
"merlot",
"cabernet sauvignon",
"pinot noir"
],
"pairing_text": "Merlot, Cabernet Sauvignon, and Pinot Noir are my top picks for Steak. After all, beef and red wine are a classic combination. Generally, leaner steaks go well with light or medium-bodied reds, such as pinot noir or merlot, while fattier steaks can handle a bold red, such as cabernet sauvingnon. The Sterling Vineyards Merlot with a 5 out of 5 star rating seems like a good match. It costs about 29 dollars per bottle.",
"product_matches": [
{
"average_rating": 1.0,
"description": null,
"id": 428278,
"image": "https://img.spoonacular.com/products/428278-312x231.jpg",
"link": "https://www.amazon.com/2014-Sterling-Vineyards-Valley-Merlot/dp/B071FP8NPG?tag=spoonacular-20",
"price": "$28.99",
"price_usd": 28.99,
"rating_count": 1.0,
"score": 0.75,
"title": "Sterling Vineyards Merlot"
}
]
}
```
### Get an ingredient
Get an ingredient by ID in an amount, such as 150 grams of pineapple: its nutrition, estimated cost, supermarket aisle, categories and the units it comes in.
**Inputs**
- Ingredient ID (`ingredient_id`, text, required): The ingredient's Spoonacular ID, such as 9266 for pineapple. Search ingredients returns it.
- Amount (`amount`, number): Optional. How much, such as 150. 1 when left empty. At least 0.
- Unit (`unit`, text): Optional. The amount's unit, such as grams or cups, with an amount.
- Category names in (`locale`, text): Optional. Name categories in American or British English. American when left empty. One of: `en_US` (American English), `en_GB` (British English).
**Outputs**: An ingredient, in an amount.
- `aisle` (text): The supermarket aisle it is found in.
- `amount` (number): How much.
- `category_path` (list): Its categories, narrowest first.
- `consistency` (text): solid or liquid.
- `estimated_cost_cents` (number): What the amount costs, in US cents.
- `id` (number): The ingredient's ID.
- `image` (text): A link to a picture of it.
- `meta` (list): Words describing it, such as chopped.
- `name` (text): Its name.
- `name_clean` (text): Its plain name, where it differs.
- `nutrition` (object): Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
- `original` (text): The line as it was given.
- `original_name` (text): The name as it was given.
- `possible_units` (list): The units it can be measured in.
- `shopping_list_units` (list): The units it is bought in.
- `unit` (text): The unit, as given.
- `unit_long` (text): The unit, in full.
- `unit_short` (text): The unit, short.
**Example output**
```json
{
"aisle": "Produce",
"amount": 1.0,
"category_path": [
"tropical fruit",
"fruit"
],
"consistency": "solid",
"estimated_cost_cents": 299.0,
"id": 9266,
"image": "https://img.spoonacular.com/ingredients_100x100/pineapple.jpg",
"meta": [],
"name": "pineapples",
"name_clean": null,
"nutrition": {
"caloric_breakdown": {
"percent_carbs": 94.18,
"percent_fat": 1.94,
"percent_protein": 3.88
},
"calories": 452.5,
"carbohydrates_g": 118.74,
"cholesterol_mg": 0.0,
"fat_g": 1.09,
"fiber_g": 12.67,
"flavonoids": [
{
"amount": 0.0,
"name": "Cyanidin",
"unit": "mg"
}
],
"ingredients": [],
"net_carbohydrates_g": 106.07,
"nutrients": [
{
"amount": 452.5,
"name": "Calories",
"percent_of_daily_needs": 22.63,
"unit": "cal"
},
{
"amount": 1.09,
"name": "Fat",
"percent_of_daily_needs": 1.67,
"unit": "g"
},
{
"amount": 0.08,
"name": "Saturated Fat",
"percent_of_daily_needs": 0.51,
"unit": "g"
},
{
"amount": 118.74,
"name": "Carbohydrates",
"percent_of_daily_needs": 39.58,
"unit": "g"
},
{
"amount": 106.07,
"name": "Net Carbohydrates",
"percent_of_daily_needs": 38.57,
"unit": "g"
},
{
"amount": 89.14,
"name": "Sugar",
"percent_of_daily_needs": 99.05,
"unit": "g"
},
{
"amount": 0.0,
"name": "Cholesterol",
"percent_of_daily_needs": 0.0,
"unit": "mg"
},
{
"amount": 9.05,
"name": "Sodium",
"percent_of_daily_needs": 0.39,
"unit": "mg"
},
{
"amount": 4.89,
"name": "Protein",
"percent_of_daily_needs": 9.77,
"unit": "g"
},
{
"amount": 432.59,
"name": "Vitamin C",
"percent_of_daily_needs": 524.35,
"unit": "mg"
},
{
"amount": 8.39,
"name": "Manganese",
"percent_of_daily_needs": 419.47,
"unit": "mg"
},
{
"amount": 12.67,
"name": "Fiber",
"percent_of_daily_needs": 50.68,
"unit": "g"
},
{
"amount": 1.01,
"name": "Vitamin B6",
"percent_of_daily_needs": 50.68,
"unit": "mg"
},
{
"amount": 1.0,
"name": "Copper",
"percent_of_daily_needs": 49.78,
"unit": "mg"
},
{
"amount": 0.72,
"name": "Vitamin B1",
"percent_of_daily_needs": 47.66,
"unit": "mg"
},
{
"amount": 162.9,
"name": "Folate",
"percent_of_daily_needs": 40.73,
"unit": "\u00b5g"
},
{
"amount": 986.45,
"name": "Potassium",
"percent_of_daily_needs": 28.18,
"unit": "mg"
},
{
"amount": 108.6,
"name": "Magnesium",
"percent_of_daily_needs": 27.15,
"unit": "mg"
},
{
"amount": 4.53,
"name": "Vitamin B3",
"percent_of_daily_needs": 22.63,
"unit": "mg"
},
{
"amount": 1.93,
"name": "Vitamin B5",
"percent_of_daily_needs": 19.28,
"unit": "mg"
},
{
"amount": 0.29,
"name": "Vitamin B2",
"percent_of_daily_needs": 17.04,
"unit": "mg"
},
{
"amount": 2.62,
"name": "Iron",
"percent_of_daily_needs": 14.58,
"unit": "mg"
},
{
"amount": 117.65,
"name": "Calcium",
"percent_of_daily_needs": 11.77,
"unit": "mg"
},
{
"amount": 524.9,
"name": "Vitamin A",
"percent_of_daily_needs": 10.5,
"unit": "IU"
},
{
"amount": 1.09,
"name": "Zinc",
"percent_of_daily_needs": 7.24,
"unit": "mg"
},
{
"amount": 72.4,
"name": "Phosphorus",
"percent_of_daily_needs": 7.24,
"unit": "mg"
},
{
"amount": 6.34,
"name": "Vitamin K",
"percent_of_daily_needs": 6.03,
"unit": "\u00b5g"
},
{
"amount": 0.91,
"name": "Selenium",
"percent_of_daily_needs": 1.29,
"unit": "\u00b5g"
},
{
"amount": 0.18,
"name": "Vitamin E",
"percent_of_daily_needs": 1.21,
"unit": "mg"
}
],
"properties": [
{
"amount": 58.67,
"name": "Glycemic Index",
"unit": null
},
{
"amount": 62.23,
"name": "Glycemic Load",
"unit": null
}
],
"protein_g": 4.89,
"saturated_fat_g": 0.08,
"sodium_mg": 9.05,
"sugar_g": 89.14,
"weight_per_serving": {
"amount": 905,
"unit": "g"
}
},
"original": "pineapples",
"original_name": "pineapples",
"possible_units": [
"piece",
"slice",
"fruit"
],
"shopping_list_units": [
"pieces"
],
"unit": null,
"unit_long": null,
"unit_short": null
}
```
### Get comparable products
Find products comparable to one, by its barcode (UPC), grouped by what they compare on: calories, likes, price, protein, Spoonacular's score and sugar.
**Inputs**
- UPC (`upc`, text, required): The product's barcode number (UPC), such as 041631000564. Spoonacular knows mostly products sold in the US.
**Outputs**
- `calories` (list): Comparable products, by calories.
- `count` (number): How many came back in all.
- `likes` (list): Comparable products, by likes.
- `price` (list): Comparable products, by price.
- `protein` (list): Comparable products, by protein.
- `spoonacular_score` (list): Comparable products, by Spoonacular's score.
- `sugar` (list): Comparable products, by sugar.
**Example output**
```json
{
"calories": [],
"count": 6,
"likes": [],
"price": [],
"protein": [
{
"difference": 3,
"id": 11797,
"image": "https://webknox.com/productImages/11797.jpg",
"title": "Casa Visco Capers"
},
{
"difference": 1,
"id": 90962,
"image": "https://webknox.com/productImages/90962.jpg",
"title": "Colavita Capers"
},
{
"difference": 1,
"id": 88139,
"image": "https://webknox.com/productImages/88139.jpg",
"title": "Mezzetta Capers"
}
],
"spoonacular_score": [
{
"difference": 7,
"id": 125354,
"image": "https://webknox.com/productImages/125354.jpg",
"title": "DeLallo Capers"
},
{
"difference": 7,
"id": 118361,
"image": "https://webknox.com/productImages/118361.jpg",
"title": "Haddon House Non Pareil Capers"
},
{
"difference": 7,
"id": 113686,
"image": "https://webknox.com/productImages/113686.jpg",
"title": "Dell Alpe Capers"
}
],
"sugar": []
}
```
### Get dishes for a wine
Find dishes that go well with a kind of wine, such as steak and stew with malbec, and why.
**Inputs**
- Wine (`wine`, text, required): The kind of wine, such as merlot, riesling or malbec, or a family such as dry red wine. Pick one from the list or type it.
**Outputs**
- `count` (number): How many came back.
- `dishes` (list): The dishes that go with it.
- `text` (text): The wine described, and why the dishes go with it.
**Example output**
```json
{
"count": 3,
"dishes": [
"stew",
"steak",
"chili"
],
"text": "Malbec is a dry red wine which is bold and full bodied. It goes especially well with round steak, tri tip steak, steak, boneless pork chops, and pizza burger."
}
```
### Get ingredient substitutes
Get what to use instead of an ingredient, such as 1 cup = 7/8 cup shortening and 1/2 tsp salt for butter. Empty when Spoonacular knows none.
**Inputs**
- Ingredient (`ingredient`, text, required): The ingredient's name, such as butter, or its ID.
**Outputs**
- `count` (number): How many came back.
- `ingredient` (text): The ingredient they replace.
- `message` (text): Spoonacular's note on what it found.
- `substitutes` (list): Each substitute, with how much to use.
**Example output**
```json
{
"count": 3,
"ingredient": "butter",
"message": "Found 4 substitutes for the ingredient.",
"substitutes": [
"1 cup = 7/8 cup shortening and 1/2 tsp salt",
"1 cup = 7/8 cup vegetable oil + 1/2 tsp salt",
"1/2 cup = 1/4 cup buttermilk + 1/4 cup unsweetened applesauce"
]
}
```
### Get random food trivia
Get a random food fact.
**Inputs**: None.
**Outputs**
- `text` (text): The fact.
**Example output**
```json
{
"text": "The red food-coloring carmine used in Skittles and other candies is made from boiled cochineal bugs, a type of beetle."
}
```
### Get random recipes
Get random popular recipes, each as Get a recipe gives it: a recipe of the day, say. Narrow them with tags such as vegetarian, dessert or italian. Costs 1 point plus 0.01 a recipe, and 0.5 a recipe with nutrition.
**Inputs**
- With tags (`include_tags`, list): Optional. Tags every recipe must have, separated by commas: diets, meal types, cuisines or intolerances, such as vegetarian, dessert.
- Without tags (`exclude_tags`, list): Optional. Tags no recipe may have, separated by commas, such as dairy, quinoa.
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- How many (`number`, number): Optional. How many recipes to return, from 1 to 100. 1 when left empty. From 1 to 100.
**Outputs**
- `count` (number): How many came back.
- `recipes` (list): The recipes.
**Example output**
```json
{
"count": 1,
"recipes": [
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-556x370.jpg",
"image_type": "jpg",
"ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": "solid",
"extended_name": null,
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
},
"us": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
}
},
"meta": [],
"name": "butter",
"name_clean": null,
"original": "1 tbsp butter",
"original_name": "butter",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Produce",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 10011135,
"image": "https://img.spoonacular.com/ingredients_100x100/cauliflower.jpg",
"measures": {
"metric": {
"amount": 473.176,
"unit_long": "milliliters",
"unit_short": "ml"
},
"us": {
"amount": 2.0,
"unit_long": "cups",
"unit_short": "cups"
}
},
"meta": [
"frozen",
"thawed",
"cut into bite-sized pieces"
],
"name": "cauliflower florets",
"name_clean": null,
"original": "about 2 cups frozen cauliflower florets, thawed, cut into bite-sized pieces",
"original_name": "about frozen cauliflower florets, thawed, cut into bite-sized pieces",
"unit": "cups",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Cheese",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 1041009,
"image": "https://img.spoonacular.com/ingredients_100x100/cheddar-cheese.png",
"measures": {
"metric": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
},
"us": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
}
},
"meta": [
"grated",
"(I used romano)"
],
"name": "cheese",
"name_clean": null,
"original": "2 tbsp grated cheese (I used romano)",
"original_name": "grated cheese (I used romano)",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
}
],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": {
"paired_wines": [
"chardonnay",
"gruener veltliner",
"sauvignon blanc"
],
"pairing_text": "Chardonnay, Gruener Veltliner, and Sauvignon Blanc are great choices for Pasta. Sauvignon Blanc and Gruner Veltliner both have herby notes that complement salads with enough acid to match tart vinaigrettes, while a Chardonnay can be a good pick for creamy salad dressings. The Buddha Kat Winery Chardonnay with a 4 out of 5 star rating seems like a good match. It costs about 25 dollars per bottle.",
"product_matches": [
{
"average_rating": 0.8,
"description": "We barrel ferment our Chardonnay and age it in a mix of Oak and Stainless. Giving this light bodied wine modest oak character, a delicate floral aroma, and a warming finish.",
"id": 469199,
"image": "https://img.spoonacular.com/products/469199-312x231.jpg",
"link": "https://www.amazon.com/2015-Buddha-Kat-Winery-Chardonnay/dp/B00OSAVVM4?tag=spoonacular-20",
"price": "$25.0",
"price_usd": 25.0,
"rating_count": 1.0,
"score": 0.55,
"title": "Buddha Kat Winery Chardonnay"
}
]
}
}
]
}
```
### Get recipe instructions
Get a recipe's method step by step, each step with the ingredients and equipment it uses and any time or oven temperature, plus every ingredient and piece of equipment needed, once each.
**Inputs**
- Recipe ID (`recipe_id`, text, required): The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- Break steps down (`step_breakdown`, true/false): Optional. Split long steps into smaller ones.
**Outputs**
- `count` (number): How many came back.
- `equipment` (list): Every piece of equipment the method uses, once each.
- `ingredients` (list): Every ingredient the method uses, once each.
- `steps` (list): The method, step by step, every part in order.
**Example output**
```json
{
"count": 6,
"equipment": [
{
"id": 404784,
"image": "https://img.spoonacular.com/equipment_100x100/oven.jpg",
"name": "oven"
},
{
"id": 404661,
"image": "https://img.spoonacular.com/equipment_100x100/whisk.png",
"name": "whisk"
},
{
"id": 404783,
"image": "https://img.spoonacular.com/equipment_100x100/bowl.jpg",
"name": "bowl"
},
{
"id": 404669,
"image": "https://img.spoonacular.com/equipment_100x100/sauce-pan.jpg",
"name": "sauce pan"
},
{
"id": 404771,
"image": "https://img.spoonacular.com/equipment_100x100/food-processor.png",
"name": "food processor"
},
{
"id": 404730,
"image": "https://img.spoonacular.com/equipment_100x100/plastic-wrap.jpg",
"name": "plastic wrap"
}
],
"ingredients": [
{
"id": 19334,
"image": "https://img.spoonacular.com/ingredients_100x100/light-brown-sugar.jpg",
"name": "light brown sugar"
},
{
"id": 19335,
"image": "https://img.spoonacular.com/ingredients_100x100/sugar-in-bowl.png",
"name": "granulated sugar"
},
{
"id": 18371,
"image": "https://img.spoonacular.com/ingredients_100x100/white-powder.jpg",
"name": "baking powder"
},
{
"id": 2050,
"image": "https://img.spoonacular.com/ingredients_100x100/vanilla-extract.jpg",
"name": "vanilla extract"
},
{
"id": 93622,
"image": "https://img.spoonacular.com/ingredients_100x100/vanilla.jpg",
"name": "vanilla bean"
},
{
"id": 1230,
"image": "https://img.spoonacular.com/ingredients_100x100/buttermilk.jpg",
"name": "buttermilk"
},
{
"id": 10014037,
"image": "https://img.spoonacular.com/ingredients_100x100/bourbon.png",
"name": "bourbon"
},
{
"id": 19304,
"image": "https://img.spoonacular.com/ingredients_100x100/molasses.jpg",
"name": "molasses"
},
{
"id": 2047,
"image": "https://img.spoonacular.com/ingredients_100x100/salt.jpg",
"name": "salt"
}
],
"steps": [
{
"equipment": [
{
"id": 404784,
"image": "https://img.spoonacular.com/equipment_100x100/oven.jpg",
"name": "oven",
"temperature": {
"number": 200.0,
"unit": "Fahrenheit"
}
}
],
"group": null,
"ingredients": [],
"length": null,
"number": 1,
"step": "Preheat the oven to 200 degrees F."
},
{
"equipment": [
{
"id": 404661,
"image": "https://img.spoonacular.com/equipment_100x100/whisk.png",
"name": "whisk",
"temperature": null
},
{
"id": 404783,
"image": "https://img.spoonacular.com/equipment_100x100/bowl.jpg",
"name": "bowl",
"temperature": null
}
],
"group": null,
"ingredients": [
{
"id": 19334,
"image": "https://img.spoonacular.com/ingredients_100x100/light-brown-sugar.jpg",
"name": "light brown sugar"
},
{
"id": 19335,
"image": "https://img.spoonacular.com/ingredients_100x100/sugar-in-bowl.png",
"name": "granulated sugar"
},
{
"id": 18371,
"image": "https://img.spoonacular.com/ingredients_100x100/white-powder.jpg",
"name": "baking powder"
}
],
"length": null,
"number": 2,
"step": "Whisk together the flour, pecans, granulated sugar, light brown sugar, baking powder, baking soda, and salt in a medium bowl."
},
{
"equipment": [
{
"id": 404661,
"image": "https://img.spoonacular.com/equipment_100x100/whisk.png",
"name": "whisk",
"temperature": null
},
{
"id": 404783,
"image": "https://img.spoonacular.com/equipment_100x100/bowl.jpg",
"name": "bowl",
"temperature": null
}
],
"group": null,
"ingredients": [
{
"id": 2050,
"image": "https://img.spoonacular.com/ingredients_100x100/vanilla-extract.jpg",
"name": "vanilla extract"
},
{
"id": 93622,
"image": "https://img.spoonacular.com/ingredients_100x100/vanilla.jpg",
"name": "vanilla bean"
},
{
"id": 1230,
"image": "https://img.spoonacular.com/ingredients_100x100/buttermilk.jpg",
"name": "buttermilk"
}
],
"length": null,
"number": 3,
"step": "Whisk together the eggs, buttermilk, butter and vanilla extract and vanilla bean in a small bowl."
},
{
"equipment": [
{
"id": 404669,
"image": "https://img.spoonacular.com/equipment_100x100/sauce-pan.jpg",
"name": "sauce pan",
"temperature": null
}
],
"group": "Bourbon Molasses Butter",
"ingredients": [
{
"id": 10014037,
"image": "https://img.spoonacular.com/ingredients_100x100/bourbon.png",
"name": "bourbon"
},
{
"id": 19335,
"image": "https://img.spoonacular.com/ingredients_100x100/sugar-in-bowl.png",
"name": "sugar"
}
],
"length": null,
"number": 1,
"step": "Combine the bourbon and sugar in a small saucepan and cook over high heat until reduced to 3 tablespoons, remove and let cool."
},
{
"equipment": [
{
"id": 404771,
"image": "https://img.spoonacular.com/equipment_100x100/food-processor.png",
"name": "food processor",
"temperature": null
}
],
"group": "Bourbon Molasses Butter",
"ingredients": [
{
"id": 19304,
"image": "https://img.spoonacular.com/ingredients_100x100/molasses.jpg",
"name": "molasses"
},
{
"id": 10014037,
"image": "https://img.spoonacular.com/ingredients_100x100/bourbon.png",
"name": "bourbon"
},
{
"id": 2047,
"image": "https://img.spoonacular.com/ingredients_100x100/salt.jpg",
"name": "salt"
}
],
"length": null,
"number": 2,
"step": "Put the butter, molasses, salt and cooled bourbon mixture in a food processor and process until smooth."
},
{
"equipment": [
{
"id": 404730,
"image": "https://img.spoonacular.com/equipment_100x100/plastic-wrap.jpg",
"name": "plastic wrap",
"temperature": null
},
{
"id": 404783,
"image": "https://img.spoonacular.com/equipment_100x100/bowl.jpg",
"name": "bowl",
"temperature": null
}
],
"group": "Bourbon Molasses Butter",
"ingredients": [],
"length": null,
"number": 3,
"step": "Scrape into a bowl, cover with plastic wrap and refrigerate for at least 1 hour to allow the flavors to meld."
}
]
}
```
### Get several recipes
Get up to 100 recipes by ID in one request, each as Get a recipe gives it. Cheaper than one at a time: 1 point for the first and 0.5 for each after it.
**Inputs**
- Recipe IDs (`recipe_ids`, list, required): The recipes' IDs, separated by commas, such as 716429, 715538. The recipes an earlier step found work too.
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
**Outputs**
- `count` (number): How many came back.
- `missing_ids` (list): Any IDs Spoonacular has no recipe for.
- `recipes` (list): The recipes, in no particular order.
**Example output**
```json
{
"count": 1,
"missing_ids": [],
"recipes": [
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-556x370.jpg",
"image_type": "jpg",
"ingredients": [
{
"aisle": "Milk, Eggs, Other Dairy",
"amount": 1.0,
"consistency": "solid",
"extended_name": null,
"id": 1001,
"image": "https://img.spoonacular.com/ingredients_100x100/butter-sliced.jpg",
"measures": {
"metric": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
},
"us": {
"amount": 1.0,
"unit_long": "Tbsp",
"unit_short": "Tbsp"
}
},
"meta": [],
"name": "butter",
"name_clean": null,
"original": "1 tbsp butter",
"original_name": "butter",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Produce",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 10011135,
"image": "https://img.spoonacular.com/ingredients_100x100/cauliflower.jpg",
"measures": {
"metric": {
"amount": 473.176,
"unit_long": "milliliters",
"unit_short": "ml"
},
"us": {
"amount": 2.0,
"unit_long": "cups",
"unit_short": "cups"
}
},
"meta": [
"frozen",
"thawed",
"cut into bite-sized pieces"
],
"name": "cauliflower florets",
"name_clean": null,
"original": "about 2 cups frozen cauliflower florets, thawed, cut into bite-sized pieces",
"original_name": "about frozen cauliflower florets, thawed, cut into bite-sized pieces",
"unit": "cups",
"unit_long": null,
"unit_short": null
},
{
"aisle": "Cheese",
"amount": 2.0,
"consistency": "solid",
"extended_name": null,
"id": 1041009,
"image": "https://img.spoonacular.com/ingredients_100x100/cheddar-cheese.png",
"measures": {
"metric": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
},
"us": {
"amount": 2.0,
"unit_long": "Tbsps",
"unit_short": "Tbsps"
}
},
"meta": [
"grated",
"(I used romano)"
],
"name": "cheese",
"name_clean": null,
"original": "2 tbsp grated cheese (I used romano)",
"original_name": "grated cheese (I used romano)",
"unit": "tbsp",
"unit_long": null,
"unit_short": null
}
],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": {
"paired_wines": [
"chardonnay",
"gruener veltliner",
"sauvignon blanc"
],
"pairing_text": "Chardonnay, Gruener Veltliner, and Sauvignon Blanc are great choices for Pasta. Sauvignon Blanc and Gruner Veltliner both have herby notes that complement salads with enough acid to match tart vinaigrettes, while a Chardonnay can be a good pick for creamy salad dressings. The Buddha Kat Winery Chardonnay with a 4 out of 5 star rating seems like a good match. It costs about 25 dollars per bottle.",
"product_matches": [
{
"average_rating": 0.8,
"description": "We barrel ferment our Chardonnay and age it in a mix of Oak and Stainless. Giving this light bodied wine modest oak character, a delicate floral aroma, and a warming finish.",
"id": 469199,
"image": "https://img.spoonacular.com/products/469199-312x231.jpg",
"link": "https://www.amazon.com/2015-Buddha-Kat-Winery-Chardonnay/dp/B00OSAVVM4?tag=spoonacular-20",
"price": "$25.0",
"price_usd": 25.0,
"rating_count": 1.0,
"score": 0.55,
"title": "Buddha Kat Winery Chardonnay"
}
]
}
}
]
}
```
### Get similar recipes
Find recipes like a given one, each with its time, servings and source. Costs 1 point plus 0.01 a recipe.
**Inputs**
- Recipe ID (`recipe_id`, text, required): The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- How many (`number`, number): Optional. How many recipes to return, from 1 to 100. 10 when left empty. From 1 to 100.
**Outputs**
- `count` (number): How many came back.
- `recipes` (list): The similar recipes.
**Example output**
```json
{
"count": 2,
"recipes": [
{
"id": 209128,
"image": "https://img.spoonacular.com/recipes/209128-556x370.jpg",
"image_type": "jpg",
"ready_in_minutes": 45,
"servings": 4,
"source_url": "http://www.seriouseats.com/recipes/2008/07/grilled-romesco-style-pork-salad-recipe.html",
"title": "Dinner Tonight: Grilled Romesco-Style Pork"
},
{
"id": 31868,
"image": "https://img.spoonacular.com/recipes/31868-556x370.jpg",
"image_type": "jpg",
"ready_in_minutes": 45,
"servings": 2,
"source_url": "http://www.seriouseats.com/recipes/2009/06/dinner-tonight-chickpea-bruschetta-babbo-nyc-recipe.html",
"title": "Dinner Tonight: Chickpea Bruschetta"
}
]
}
```
### Get wine recommendations
Recommend bottles on sale of a kind of wine, such as merlot, within a price and above a rating, each with its price, rating and a link to buy it. Costs 1 point plus 0.01 for every matching bottle, not only those returned.
**Inputs**
- Wine (`wine`, text, required): The kind of wine, such as merlot, riesling or malbec, or a family such as dry red wine. Pick one from the list or type it.
- Maximum price (`max_price`, number): Optional. The most a recommended bottle may cost, in US dollars. At least 1.
- Minimum rating (`min_rating`, number): Optional. The lowest rating, from 0 to 1: 0.8 is four stars of five. From 0 to 1.
- How many (`number`, number): Optional. How many wines to return, from 1 to 100. 5 when left empty. From 1 to 100.
**Outputs**
- `count` (number): How many came back.
- `total_results` (number): How many there are in all, of which this is one page.
- `wines` (list): The wines, best first.
**Example output**
```json
{
"count": 2,
"total_results": 21,
"wines": [
{
"average_rating": 0.96,
"description": "Enticing and lively red color; beautifully aromatic with black cherry and ripe plum. On the palate a purity of blackcurrant, cedar and mint flavors blend together seamlessly. Soft and supple, this wine has a medium-bodied mouth-feel with plush tannins that integrate with the generous finish.Our favorite pairings for this wine include chicken parmesan, cedar-planked salmon over wild rice, and mushroom pizza.",
"id": 447938,
"image": "https://img.spoonacular.com/products/447938-312x231.jpg",
"link": "https://click.linksynergy.com/deeplink?id=*QCiIS6t4gA&mid=2025&murl=https%3A%2F%2Fwww.wine.com%2Fproduct%2Frombauer-merlot-2008%2F116883",
"price": "$25.59",
"price_usd": 25.59,
"rating_count": 5.0,
"score": 0.8975,
"title": "Rombauer Merlot"
},
{
"average_rating": 0.9,
"description": "A ripe and rounded Merlot with notes of plum, blackberry, and hint of spice.",
"id": 430475,
"image": "https://img.spoonacular.com/products/430475-312x231.jpg",
"link": "https://www.amazon.com/Big-Kahuna-Merlot-Red-Wine/dp/B01F5XPTUW?tag=spoonacular-20",
"price": "$6.99",
"price_usd": 6.99,
"rating_count": 4.0,
"score": 0.823076923076923,
"title": "NV The Big Kahuna Merlot"
}
]
}
```
### Map ingredients to products
Find grocery products to buy for each ingredient on a list, such as eggs and bacon, each with its UPC. Costs 1 point an ingredient.
**Inputs**
- Ingredients (`ingredients`, list, required): The ingredients, separated by commas, such as eggs, bacon.
- Servings (`servings`, number): Optional. How many servings to buy for. 1 when left empty. At least 1.
**Outputs**
- `count` (number): How many came back.
- `ingredients` (list): Each ingredient, with products.
**Example output**
```json
{
"count": 2,
"ingredients": [
{
"image": "https://img.spoonacular.com/ingredients_100x100/egg.png",
"meta": [
"egg"
],
"original": "eggs",
"original_name": "eggs",
"products": [
{
"id": 209945,
"title": "Crystal Farms Eggs - Fresh Accents Peeled Hard Cooked 2 ct Packs",
"upc": "075925889498"
},
{
"id": 214723,
"title": "Organic Valley Eggs - Organic Medium Brown",
"upc": "093966811100"
},
{
"id": 183228,
"title": "Eggland's Best Grade A Eggs Jumbo - 12 CT",
"upc": "715141328615"
}
]
},
{
"image": "https://img.spoonacular.com/ingredients_100x100/raw-bacon.png",
"meta": [
"bacon"
],
"original": "bacon",
"original_name": "bacon",
"products": [
{
"id": 159164,
"title": "Wright Bacon - Naturally Hickory Smoked",
"upc": "079621461552"
},
{
"id": 87924,
"title": "Sugardale Bacon",
"upc": "073890006025"
},
{
"id": 213315,
"title": "John Morrell Bacon - Applewood Smoked",
"upc": "070100060877"
}
]
}
]
}
```
### Parse ingredients
Read ingredient lines such as 2 cups flour, sifted into their ingredient, amount and unit, with each one's aisle, estimated cost and units, and optionally its nutrition. Costs 1 point a line, or 1.1 with nutrition.
**Inputs**
- Ingredients (`ingredients`, list, required): The ingredient lines, one a line, such as 1 cup green tea. Up to 100.
- Servings (`servings`, number): Optional. How many servings the lines make, which nutrition is divided by. 1 when left empty. At least 1.
- Include nutrition (`include_nutrition`, true/false): Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Language (`language`, text): Optional. The language the text is in. English when left empty. One of: `en` (English), `de` (German).
**Outputs**
- `count` (number): How many came back.
- `ingredients` (list): Each line, read, in order.
**Example output**
```json
{
"count": 1,
"ingredients": [
{
"aisle": "Tea and Coffee",
"amount": 1.0,
"category_path": [],
"consistency": "solid",
"estimated_cost_cents": 1786.86,
"id": 10014355,
"image": "https://img.spoonacular.com/ingredients_100x100/green-tea-leaves.jpg",
"meta": [
"green"
],
"name": "tea",
"name_clean": null,
"nutrition": {
"caloric_breakdown": {
"percent_carbs": 100.0,
"percent_fat": 0.0,
"percent_protein": 0.0
},
"calories": 2.36,
"carbohydrates_g": 0.71,
"cholesterol_mg": 0.0,
"fat_g": 0.0,
"fiber_g": null,
"flavonoids": [
{
"amount": 0.0,
"name": "Cyanidin",
"unit": null
},
{
"amount": 0.0,
"name": "Petunidin",
"unit": null
},
{
"amount": 0.0,
"name": "Delphinidin",
"unit": null
}
],
"ingredients": [],
"net_carbohydrates_g": 0.71,
"nutrients": [
{
"amount": 2.36,
"name": "Calories",
"percent_of_daily_needs": 0.12,
"unit": "kcal"
},
{
"amount": 0.0,
"name": "Fat",
"percent_of_daily_needs": 0.0,
"unit": "g"
},
{
"amount": 0.0,
"name": "Saturated Fat",
"percent_of_daily_needs": 0.03,
"unit": "g"
},
{
"amount": 0.71,
"name": "Carbohydrates",
"percent_of_daily_needs": 0.24,
"unit": "g"
},
{
"amount": 0.71,
"name": "Net Carbohydrates",
"percent_of_daily_needs": 0.26,
"unit": "g"
},
{
"amount": 0.0,
"name": "Sugar",
"percent_of_daily_needs": 0.0,
"unit": "g"
},
{
"amount": 0.0,
"name": "Cholesterol",
"percent_of_daily_needs": 0.0,
"unit": "mg"
},
{
"amount": 7.08,
"name": "Sodium",
"percent_of_daily_needs": 0.31,
"unit": "mg"
},
{
"amount": 47.2,
"name": "Caffeine",
"percent_of_daily_needs": 15.73,
"unit": "mg"
},
{
"amount": 0.0,
"name": "Protein",
"percent_of_daily_needs": 0.0,
"unit": "g"
},
{
"amount": 0.52,
"name": "Manganese",
"percent_of_daily_needs": 25.84,
"unit": "mg"
},
{
"amount": 11.8,
"name": "Folate",
"percent_of_daily_needs": 2.95,
"unit": "\u00b5g"
},
{
"amount": 87.32,
"name": "Potassium",
"percent_of_daily_needs": 2.49,
"unit": "mg"
},
{
"amount": 0.03,
"name": "Vitamin B2",
"percent_of_daily_needs": 1.94,
"unit": "mg"
},
{
"amount": 7.08,
"name": "Magnesium",
"percent_of_daily_needs": 1.77,
"unit": "mg"
},
{
"amount": 0.02,
"name": "Copper",
"percent_of_daily_needs": 1.18,
"unit": "mg"
}
],
"properties": [
{
"amount": 0.0,
"name": "Glycemic Index",
"unit": null
},
{
"amount": 0.0,
"name": "Glycemic Load",
"unit": null
}
],
"protein_g": 0.0,
"saturated_fat_g": 0.0,
"sodium_mg": 7.08,
"sugar_g": 0.0,
"weight_per_serving": {
"amount": 236,
"unit": "g"
}
},
"original": "1 cup green tea",
"original_name": "green tea",
"possible_units": [
"g",
"oz",
"fluid ounce"
],
"shopping_list_units": [],
"unit": "cup",
"unit_long": "cup",
"unit_short": "cup"
}
]
}
```
### Search food videos
Search YouTube's recipe and food videos, by words, meal type, cuisine, diet, ingredients and length, each with its link, thumbnail, views and rating. Costs 1 point plus 0.01 a video.
**Inputs**
- Search (`query`, text, required): What to search for, such as chicken soup.
- Meal type (`meal_type`, text): Optional. Only this kind of dish, such as Main course or Dessert. One of: `main course`, `side dish`, `dessert`, `appetizer`, `salad`, `bread`, `breakfast`, `soup`, `beverage`, `sauce`, and 4 more.
- Cuisines (`cuisines`, text): Optional. Only videos of any of these cuisines. One or more of: `african`, `american`, `asian`, `british`, `cajun`, `caribbean`, `chinese`, `eastern european`, `european`, `french`, and 17 more.
- Diet (`diet`, text): Optional. Only videos of recipes for this diet. One of: `gluten free`, `ketogenic`, `vegetarian`, `lacto-vegetarian`, `ovo-vegetarian`, `vegan`, `pescetarian`, `paleo`, `primal`, `low fodmap`, `whole30`.
- With ingredients (`include_ingredients`, list): Optional. Ingredients the recipes should use, separated by commas, such as tomato, cheese.
- Without ingredients (`exclude_ingredients`, list): Optional. Ingredients or kinds of ingredient the recipes must not have, separated by commas, such as eggs, nuts.
- Shortest (seconds) (`min_length`, number): Optional. The shortest a video may be, in seconds. At least 0.
- Longest (seconds) (`max_length`, number): Optional. The longest a video may be, in seconds. At least 0.
- How many (`number`, number): Optional. How many videos to return, from 1 to 100. 10 when left empty. From 1 to 100.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 900. From 0 to 900.
**Outputs**
- `count` (number): How many came back.
- `total_results` (number): How many there are in all, of which this is one page.
- `videos` (list): The videos found, best first.
**Example output**
```json
{
"count": 2,
"total_results": 172,
"videos": [
{
"length_seconds": 370,
"rating": 0.985984219269103,
"short_title": "8 One-Pot Pastas",
"thumbnail": "https://i.ytimg.com/vi/YTZGPCCB2FU/mqdefault.jpg",
"title": "8 One-Pot Pastas",
"url": "https://www.youtube.com/watch?v=YTZGPCCB2FU",
"views": 550467,
"youtube_id": "YTZGPCCB2FU"
},
{
"length_seconds": 333,
"rating": 1.0,
"short_title": "Macaroni salad",
"thumbnail": "https://i.ytimg.com/vi/81bn4p8H3Kg/mqdefault.jpg",
"title": "Macaroni salad - pasta salad recipes - healthy recipe channel - quick tasty recipe - cooking channel",
"url": "https://www.youtube.com/watch?v=81bn4p8H3Kg",
"views": 307,
"youtube_id": "81bn4p8H3Kg"
}
]
}
```
### Search grocery products
Search 800,000 packaged grocery products by name, such as greek yogurt, optionally within calorie and nutrient limits. Costs 1 point plus 0.01 a product; details cost a point a product.
**Inputs**
- Search (`query`, text, required): What to search for, such as greek yogurt.
- Minimum calories (`min_calories`, number): Optional. The least calories a serving may have. At least 0.
- Maximum calories (`max_calories`, number): Optional. The most calories a serving may have. At least 0.
- Minimum protein (`min_protein`, number): Optional. The least grams of protein a serving may have. At least 0.
- Maximum protein (`max_protein`, number): Optional. The most grams of protein a serving may have. At least 0.
- Minimum carbohydrates (`min_carbs`, number): Optional. The least grams of carbohydrates a serving may have. At least 0.
- Maximum carbohydrates (`max_carbs`, number): Optional. The most grams of carbohydrates a serving may have. At least 0.
- Minimum fat (`min_fat`, number): Optional. The least grams of fat a serving may have. At least 0.
- Maximum fat (`max_fat`, number): Optional. The most grams of fat a serving may have. At least 0.
- Add product details (`add_product_details`, true/false): Optional. Each product's badges, ingredients, nutrition and price, for 1 point a product.
- How many (`number`, number): Optional. How many products to return, from 1 to 100. 10 when left empty. From 1 to 100.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 990. From 0 to 990.
**Outputs**
- `count` (number): How many came back.
- `offset` (number): How many were skipped.
- `products` (list): The products found.
- `total_results` (number): How many there are in all, of which this is one page.
**Example output**
```json
{
"count": 2,
"offset": 0,
"products": [
{
"aisle": null,
"badges": [],
"breadcrumbs": [],
"credits": null,
"generated_text": null,
"id": 192386,
"image": "https://img.spoonacular.com/products/192386-312x231.jpg",
"image_type": "jpg",
"important_badges": [],
"ingredient_count": null,
"ingredient_list": null,
"ingredients": [],
"likes": null,
"nutrition": null,
"price_cents": null,
"servings": {
"number": null,
"size": null,
"unit": null
},
"spoonacular_score": null,
"title": "Pizza Buddy: Frozen Pizza Dough, 16 Oz",
"upc": null
},
{
"aisle": null,
"badges": [],
"breadcrumbs": [],
"credits": null,
"generated_text": null,
"id": 27693,
"image": "https://img.spoonacular.com/products/27693-312x231.jpg",
"image_type": "jpg",
"important_badges": [],
"ingredient_count": null,
"ingredient_list": null,
"ingredients": [],
"likes": null,
"nutrition": null,
"price_cents": null,
"servings": {
"number": null,
"size": null,
"unit": null
},
"spoonacular_score": null,
"title": "Uno Pizza",
"upc": null
}
],
"total_results": 1258
}
```
### Search ingredients
Search simple foods (fruit, vegetables, nuts, grains, meat, fish, dairy) by name, with the IDs Get an ingredient takes. Narrow by how much of their calories come from protein, fat or carbohydrates.
**Inputs**
- Search (`query`, text, required): The ingredient's name, whole or in part, such as banana.
- Intolerances (`intolerances`, text): Optional. Leave out anything unsuitable for these intolerances. Spoonacular reads ingredients automatically, so it cannot be right every time: it is not medical advice. One or more of: `dairy`, `egg`, `gluten`, `grain`, `peanut`, `seafood`, `sesame`, `shellfish`, `soy`, `sulfite`, `tree nut`, `wheat`.
- Minimum % protein (`min_protein_percent`, number): Optional. The minimum share of calories from protein, from 0 to 100. From 0 to 100.
- Maximum % protein (`max_protein_percent`, number): Optional. The maximum share of calories from protein, from 0 to 100. From 0 to 100.
- Minimum % fat (`min_fat_percent`, number): Optional. The minimum share of calories from fat, from 0 to 100. From 0 to 100.
- Maximum % fat (`max_fat_percent`, number): Optional. The maximum share of calories from fat, from 0 to 100. From 0 to 100.
- Minimum % carbs (`min_carbs_percent`, number): Optional. The minimum share of calories from carbs, from 0 to 100. From 0 to 100.
- Maximum % carbs (`max_carbs_percent`, number): Optional. The maximum share of calories from carbs, from 0 to 100. From 0 to 100.
- Add kinds of each (`add_children`, true/false): Optional. Also find kinds of each food found, such as banana chips for banana.
- Add aisle and units (`meta_information`, true/false): Optional. Add each one's supermarket aisle and units.
- Sort by (`sort`, text): Optional. A nutrient to order them by. One of: `calories`, `protein`, `carbohydrates`, `total-fat` (Fat), `sugar`, `fiber`, `sodium`.
- Sort direction (`sort_direction`, text): Optional. Lowest or highest first. One of: `asc` (Lowest first), `desc` (Highest first).
- Language (`language`, text): Optional. The language the text is in. English when left empty. One of: `en` (English), `de` (German).
- How many (`number`, number): Optional. How many ingredients to return, from 1 to 100. 10 when left empty. From 1 to 100.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 990. From 0 to 990.
**Outputs**
- `count` (number): How many came back.
- `ingredients` (list): The ingredients found.
- `offset` (number): How many were skipped.
- `total_results` (number): How many there are in all, of which this is one page.
**Example output**
```json
{
"count": 2,
"ingredients": [
{
"aisle": null,
"id": 19400,
"image": "https://img.spoonacular.com/ingredients_100x100/banana-chips.jpg",
"name": "banana chips",
"possible_units": []
},
{
"aisle": null,
"id": 93779,
"image": "https://img.spoonacular.com/ingredients_100x100/limoncello.jpg",
"name": "banana liqueur",
"possible_units": []
}
],
"offset": 0,
"total_results": 13
}
```
### Search menu items
Search 115,000 dishes on the menus of 800 fast food and restaurant chains, such as a Big Mac, optionally within calorie and nutrient limits. Costs 1 point plus 0.01 an item; details cost a point an item.
**Inputs**
- Search (`query`, text, required): What to search for, such as burger.
- Minimum calories (`min_calories`, number): Optional. The least calories a serving may have. At least 0.
- Maximum calories (`max_calories`, number): Optional. The most calories a serving may have. At least 0.
- Minimum protein (`min_protein`, number): Optional. The least grams of protein a serving may have. At least 0.
- Maximum protein (`max_protein`, number): Optional. The most grams of protein a serving may have. At least 0.
- Minimum carbohydrates (`min_carbs`, number): Optional. The least grams of carbohydrates a serving may have. At least 0.
- Maximum carbohydrates (`max_carbs`, number): Optional. The most grams of carbohydrates a serving may have. At least 0.
- Minimum fat (`min_fat`, number): Optional. The least grams of fat a serving may have. At least 0.
- Maximum fat (`max_fat`, number): Optional. The most grams of fat a serving may have. At least 0.
- Add menu item details (`add_menu_item_details`, true/false): Optional. Each item's nutrition, badges and description, for 1 point an item.
- How many (`number`, number): Optional. How many menu items to return, from 1 to 10. 10 when left empty. From 1 to 10.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 990. From 0 to 990.
**Outputs**
- `count` (number): How many came back.
- `menu_items` (list): The menu items found.
- `offset` (number): How many were skipped.
- `total_results` (number): How many there are in all, of which this is one page.
**Example output**
```json
{
"count": 2,
"menu_items": [
{
"badges": [],
"breadcrumbs": [],
"generated_text": null,
"id": 419357,
"image": "https://img.spoonacular.com/menu-items/419357-312x231.png",
"image_type": "png",
"likes": null,
"nutrition": null,
"price": null,
"restaurant_chain": "Hooters",
"servings": {
"number": 1,
"size": 2,
"unit": "oz"
},
"spoonacular_score": null,
"title": "Burger Sliders"
},
{
"badges": [],
"breadcrumbs": [],
"generated_text": null,
"id": 424571,
"image": "https://img.spoonacular.com/menu-items/424571-312x231.png",
"image_type": "png",
"likes": null,
"nutrition": null,
"price": null,
"restaurant_chain": "Burger King",
"servings": {
"number": 1,
"size": 2,
"unit": "oz"
},
"spoonacular_score": null,
"title": "Bacon King Burger"
}
],
"offset": 0,
"total_results": 6749
}
```
### Search recipes
Search Spoonacular's 365,000 recipes by name or words, cuisine, diet, intolerances, meal type, ingredients, time to make, servings and nutrients, each with its details: time, servings, diets, health score, price per serving and summary. Costs 1 point plus 0.035 a recipe, and a point more with any nutrient limit.
**Inputs**
- Search (`query`, text): Optional. What to search for, in plain words, such as pasta or chicken curry.
- Cuisines (`cuisines`, text): Optional. Only recipes of any of these cuisines. One or more of: `african`, `american`, `asian`, `british`, `cajun`, `caribbean`, `chinese`, `eastern european`, `european`, `french`, and 17 more.
- Leave out cuisines (`exclude_cuisines`, text): Optional. No recipes of any of these cuisines. One or more of: `african`, `american`, `asian`, `british`, `cajun`, `caribbean`, `chinese`, `eastern european`, `european`, `french`, and 17 more.
- Diets (`diets`, text): Optional. Only recipes that suit every one of these diets. One or more of: `gluten free`, `ketogenic`, `vegetarian`, `lacto-vegetarian`, `ovo-vegetarian`, `vegan`, `pescetarian`, `paleo`, `primal`, `low fodmap`, `whole30`.
- Intolerances (`intolerances`, text): Optional. Leave out anything unsuitable for these intolerances. Spoonacular reads ingredients automatically, so it cannot be right every time: it is not medical advice. One or more of: `dairy`, `egg`, `gluten`, `grain`, `peanut`, `seafood`, `sesame`, `shellfish`, `soy`, `sulfite`, `tree nut`, `wheat`.
- Meal type (`meal_type`, text): Optional. Only this kind of dish, such as Main course or Dessert. One of: `main course`, `side dish`, `dessert`, `appetizer`, `salad`, `bread`, `breakfast`, `soup`, `beverage`, `sauce`, and 4 more.
- With ingredients (`include_ingredients`, list): Optional. Ingredients the recipes should use, separated by commas, such as tomato, cheese.
- Without ingredients (`exclude_ingredients`, list): Optional. Ingredients or kinds of ingredient the recipes must not have, separated by commas, such as eggs, nuts.
- Equipment (`equipment`, list): Optional. Only recipes made with any of this equipment, separated by commas, such as blender, frying pan.
- Title contains (`title_match`, text): Optional. Text the recipe's name must contain.
- Ready in at most (minutes) (`max_ready_time`, number): Optional. The most minutes a recipe may take, preparation and cooking together. At least 1.
- Minimum servings (`min_servings`, number): Optional. The fewest servings a recipe may make. At least 0.
- Maximum servings (`max_servings`, number): Optional. The most servings a recipe may make. At least 0.
- Minimum calories (`min_calories`, number): Optional. The least calories a serving may have. At least 0.
- Maximum calories (`max_calories`, number): Optional. The most calories a serving may have. At least 0.
- Minimum protein (`min_protein`, number): Optional. The least grams of protein a serving may have. At least 0.
- Maximum protein (`max_protein`, number): Optional. The most grams of protein a serving may have. At least 0.
- Minimum carbohydrates (`min_carbs`, number): Optional. The least grams of carbohydrates a serving may have. At least 0.
- Maximum carbohydrates (`max_carbs`, number): Optional. The most grams of carbohydrates a serving may have. At least 0.
- Minimum fat (`min_fat`, number): Optional. The least grams of fat a serving may have. At least 0.
- Maximum fat (`max_fat`, number): Optional. The most grams of fat a serving may have. At least 0.
- More nutrient limits (`nutrient_limits`, object): Optional. Limits on any other nutrient per serving, each a name and a number: min or max with the nutrient, such as minFiber 5, maxSodium 500, minVitaminC 30 or maxSugar 10. Spoonacular limits SaturatedFat, Sugar, Fiber, Cholesterol, Sodium, Alcohol, Caffeine, Calcium, Choline, Copper, Fluoride, Folate, FolicAcid, Iodine, Iron, Magnesium, Manganese, Phosphorus, Potassium, Selenium, Zinc and Vitamins A, B1, B2, B3, B5, B6, B12, C, D, E and K.
- Must have a method (`instructions_required`, true/false): Optional. Only recipes with step-by-step instructions.
- Add recipe details (`add_recipe_details`, true/false): Optional. Each recipe's time, servings, diets, scores, price and summary, for 0.025 points a recipe. On when left empty; turn it off for just names and pictures. Default: `true`.
- Add nutrition (`add_nutrition`, true/false): Optional. Each recipe's nutrition per serving too, for 0.025 points a recipe.
- Sort by (`sort`, text): Optional. How to order the recipes. Best match when left empty. With ingredients set, Most of the included ingredients used finds what to cook with what you have. One of: `meta-score` (Best match), `popularity`, `healthiness` (Health score), `price`, `time` (Time to make), `random`, `max-used-ingredients` (Most of the included ingredients used), `min-missing-ingredients` (Fewest ingredients missing), `calories`, `protein`, and 7 more.
- Sort direction (`sort_direction`, text): Optional. Lowest or highest first. One of: `asc` (Lowest first), `desc` (Highest first).
- How many (`number`, number): Optional. How many recipes to return, from 1 to 100. 10 when left empty. From 1 to 100.
- Skip (`offset`, number): Optional. How many results to skip, for the next page: up to 900. From 0 to 900.
**Outputs**
- `count` (number): How many came back.
- `offset` (number): How many were skipped.
- `recipes` (list): The recipes found, best first.
- `total_results` (number): How many there are in all, of which this is one page.
**Example output**
```json
{
"count": 1,
"offset": 0,
"recipes": [
{
"cheap": false,
"cooking_minutes": 25,
"credits_text": "Full Belly Sisters",
"cuisines": [],
"dairy_free": false,
"diets": [],
"dish_types": [
"lunch",
"main course",
"main dish"
],
"gaps": "no",
"gluten_free": false,
"health_score": 19.0,
"id": 716429,
"image": "https://img.spoonacular.com/recipes/716429-312x231.jpg",
"image_type": "jpg",
"ingredients": [],
"instructions": null,
"ketogenic": false,
"license": "CC BY-SA 3.0",
"likes": null,
"low_fodmap": false,
"nutrition": null,
"occasions": [],
"preparation_minutes": 20,
"price_per_serving_cents": 163.15,
"ready_in_minutes": 45,
"servings": 2,
"source_name": "Full Belly Sisters",
"source_url": "http://fullbellysisters.blogspot.com/2012/06/pasta-with-garlic-scallions-cauliflower.html",
"spoonacular_score": 83.0,
"spoonacular_url": "https://spoonacular.com/pasta-with-garlic-scallions-cauliflower-breadcrumbs-716429",
"steps": [],
"summary": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"summary_text": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs might be a good recipe to expand your main course repertoire. One portion of this dish contains approximately 19g of protein , 20g of fat , and a total of 584 calories . For $1.63 per serving , this recipe covers 23% of your daily requirements of vitamins and minerals. This recipe serves 2. It is brought to you by fullbellysisters.blogspot.com. 209 people were glad they tried this recipe. A mixture of scallions, salt and pepper, white wine, and a handful of other ingredients are all it takes to make this recipe so scrumptious. From preparation to the plate, this recipe takes approximately 45 minutes . All things considered, we decided this recipe deserves a spoonacular score of 83% . This score is awesome. If you like this recipe, take a look at these similar recipes: Cauliflower Gratin with Garlic Breadcrumbs, Pasta With Cauliflower, Sausage, & Breadcrumbs, and Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs.",
"sustainable": false,
"taste": null,
"title": "Pasta with Garlic, Scallions, Cauliflower & Breadcrumbs",
"vegan": false,
"vegetarian": false,
"very_healthy": false,
"very_popular": false,
"weight_watcher_smart_points": 17,
"whole30": false,
"wine_pairing": null
}
],
"total_results": 86
}
```