Spoonacular
App · Food & Drink · 41 actions
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.
Actions
| Action | What it does |
|---|---|
| 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. |
| Answer a nutrition question | Answer a food or nutrition question asked in plain words, such as How much vitamin C is in 2 apples? |
| Autocomplete ingredient names | Suggest ingredients whose names complete what someone has started typing, such as appl. |
| Autocomplete menu item names | Suggest menu items whose names complete what someone has started typing, such as chicke. |
| Autocomplete product names | Suggest grocery products whose names complete what someone has started typing, such as chicke. |
| Autocomplete recipe names | Suggest recipe names that complete what someone has started typing, such as chick. |
| 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. |
| Classify a recipe's cuisine | Work out a recipe's cuisine, such as Mediterranean, from its title and ingredients. |
| 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. |
| Convert an amount | Convert an amount of an ingredient between units, such as 2.5 cups of flour to 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get a grocery product | Get a packaged product by ID: its ingredients, badges (such as gluten free), nutrition per serving, servings, price and aisle. |
| Get a menu item | Get a restaurant chain's menu item by ID: its chain, nutrition per serving, servings and badges. |
| Get a product by UPC | Look up a packaged product by its barcode (UPC): its ingredients, badges, nutrition per serving, servings, price and aisle. |
| Get a random food joke | Get a random joke about food. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get dishes for a wine | Find dishes that go well with a kind of wine, such as steak and stew with malbec, and why. |
| 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. |
| Get random food trivia | Get a random food fact. |
| Get random recipes | Get random popular recipes, each as Get a recipe gives it: a recipe of the day, say. |
| 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. |
| Get several recipes | Get up to 100 recipes by ID in one request, each as Get a recipe gives it. |
| Get similar recipes | Find recipes like a given one, each with its time, servings and source. |
| 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. |
| Map ingredients to products | Find grocery products to buy for each ingredient on a list, such as eggs and bacon, each with its UPC. |
| 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. |
| 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. |
| Search grocery products | Search 800,000 packaged grocery products by name, such as greek yogurt, optionally within calorie and nutrient limits. |
| Search ingredients | Search simple foods (fruit, vegetables, nuts, grains, meat, fish, dairy) by name, with the IDs Get an ingredient takes. |
| 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. |
| 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. |
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
titletextRequired - The recipe's name, such as Spaghetti Carbonara.
- Servings
servingsnumberRequired - How many it serves.At least 1.
- Ingredients
ingredientslistRequired - The ingredient lines, one a line, such as 1 lb spaghetti.
- Method
instructionstext - Optional. How to make it, as text.
- Language
languagetext - Optional. The language the text is in. English when left empty.One of:
en(English),de(German). - Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste
include_tastetrue/false - Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
Outputs
A recipe.
cheaptrue/false- True if it is cheap to make.
cooking_minutesnumber- Minutes of cooking.
credits_texttext- Who to credit when showing it.
cuisineslist- Its cuisines, such as italian.
dairy_freetrue/false- True if it is dairy free.
dietslist- The diets it suits, such as gluten free.
dish_typeslist- What kind of dish it is, such as main course.
gapstext- Whether it suits the GAPS diet: no, or a stage.
gluten_freetrue/false- True if it is gluten free.
health_scorenumber- Spoonacular's health score, from 0 to 100.
idnumber- The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
imagetext- A link to its picture.
image_typetext- The picture's file type, such as jpg.
ingredientslist- Its ingredients.
instructionstext- Its method, as published.
ketogenictrue/false- True if it is ketogenic.
licensetext- Its license, such as CC BY 3.0.
likesnumber- How many people liked it.
low_fodmaptrue/false- True if it is low FODMAP.
nutritionobject- Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
occasionslist- Occasions it suits, such as christmas.
preparation_minutesnumber- Minutes of preparation.
price_per_serving_centsnumber- What a serving costs, in US cents.
ready_in_minutesnumber- Minutes from start to table.
servingsnumber- How many it serves.
source_nametext- Who published it.
source_urltext- Where it was published.
spoonacular_scorenumber- Spoonacular's overall score, from 0 to 100.
spoonacular_urltext- Its page on spoonacular.com.
stepslist- Its method, step by step.
summarytext- A summary of it, in HTML.
summary_texttext- The summary as plain text.
sustainabletrue/false- True if it is sustainable.
tasteobject- The recipe's taste, each from 0 to 100. Null unless it was asked for.
titletext- Its name.
vegantrue/false- True if it is vegan.
vegetariantrue/false- True if it is vegetarian.
very_healthytrue/false- True if it is very healthy.
very_populartrue/false- True if it is very popular.
weight_watcher_smart_pointsnumber- Its Weight Watchers SmartPoints.
whole30true/false- True if it is Whole30.
wine_pairingobject- Wines that go with the recipe. Null unless it was asked for.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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
questiontextRequired - The question, such as How much vitamin C is in 2 apples?
Outputs
answertext- The answer.
imagetext- A link to a picture of the food it is about.
Example output
{
"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
querytextRequired - The text to complete, such as appl.
- Add aisle and units
meta_informationtrue/false - Optional. Add each one's ID, supermarket aisle and units.
- Intolerances
intolerancestext - 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
languagetext - Optional. The language the text is in. English when left empty.One of:
en(English),de(German). - How many
numbernumber - Optional. How many suggestions to return, from 1 to 100. 10 when left empty.From 1 to 100.
Outputs
countnumber- How many came back.
suggestionslist- The ingredients whose names fit.
Example output
{
"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
querytextRequired - The text to complete, such as chicke.
- How many
numbernumber - Optional. How many suggestions to return, from 1 to 25. 10 when left empty.From 1 to 25.
Outputs
countnumber- How many came back.
suggestionslist- The menu items whose names fit.
Example output
{
"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
querytextRequired - The text to complete, such as chicke.
- How many
numbernumber - Optional. How many suggestions to return, from 1 to 25. 10 when left empty.From 1 to 25.
Outputs
countnumber- How many came back.
suggestionslist- The products whose names fit.
Example output
{
"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
querytextRequired - The text to complete, such as chick.
- How many
numbernumber - Optional. How many suggestions to return, from 1 to 25. 10 when left empty.From 1 to 25.
Outputs
countnumber- How many came back.
suggestionslist- The recipes whose names fit.
Example output
{
"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
titletextRequired - The product's name as on the pack or a receipt, such as Kroger Vitamin A & D Reduced Fat 2% Milk.
- UPC
upctext - Optional. Its barcode number (UPC).
- PLU code
plu_codetext - Optional. Its produce code (PLU), for loose produce.
- Category names in
localetext - Optional. Name categories in American or British English. American when left empty.One of:
en_US(American English),en_GB(British English).
Outputs
breadcrumbslist- The category and the broader ones it is in.
categorytext- Its category, such as 2 percent milk.
clean_titletext- The product's name, tidied.
imagetext- A link to a picture of the category.
usda_codenumber- The category's USDA food code.
Example output
{
"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
titletextRequired - The recipe's name, such as Pork roast with green beans.
- Ingredients
ingredientslist - Optional. Its ingredient lines, one a line.
- Language
languagetext - Optional. The language the text is in. English when left empty.One of:
en(English),de(German).
Outputs
confidencenumber- How sure Spoonacular is, from 0 to 1.
cuisinetext- The likeliest cuisine.
cuisineslist- It and the broader cuisines it belongs to.
Example output
{
"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
itemslistRequired - 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
aisleslist- The list by supermarket aisle.
cost_centsnumber- What it all costs, in US cents.
countnumber- How many came back.
itemslist- Everything to buy, aisle by aisle.
Example output
{
"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
ingredienttextRequired - The ingredient, such as flour.
- Amount
source_amountnumberRequired - How much, such as 2.5.At least 0.
- From unit
source_unittextRequired - The amount's unit, such as cups.
- To unit
target_unittextRequired - The unit to convert to, such as grams, or piece for a count.
Outputs
answertext- The conversion as a sentence.
source_amountnumber- The amount given.
source_unittext- Its unit.
target_amountnumber- The amount, converted.
target_unittext- The unit converted to.
Example output
{
"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
winetextRequired - 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
descriptiontext- The description.
winetext- The wine, as Spoonacular names it.
Example output
{
"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
dishtextRequired - The dish's name, such as Spaghetti Aglio et Olio.
Outputs
caloriesobject- An estimate.
carbsobject- An estimate.
fatobject- An estimate.
proteinobject- An estimate.
recipes_usednumber- How many recipes the estimate is made from.
Example output
{
"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
urltextRequired - The address of the recipe's page, starting with https://. Not a spoonacular.com page, which Spoonacular refuses: Get a recipe reads those.
- Analyze
analyzetrue/false - Optional. Also work out its cuisines, dish types, diets and more, for a point.
- Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste
include_tastetrue/false - Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
- Read it fresh
force_extractiontrue/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_videotrue/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.
cheaptrue/false- True if it is cheap to make.
cooking_minutesnumber- Minutes of cooking.
credits_texttext- Who to credit when showing it.
cuisineslist- Its cuisines, such as italian.
dairy_freetrue/false- True if it is dairy free.
dietslist- The diets it suits, such as gluten free.
dish_typeslist- What kind of dish it is, such as main course.
gapstext- Whether it suits the GAPS diet: no, or a stage.
gluten_freetrue/false- True if it is gluten free.
health_scorenumber- Spoonacular's health score, from 0 to 100.
idnumber- The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
imagetext- A link to its picture.
image_typetext- The picture's file type, such as jpg.
ingredientslist- Its ingredients.
instructionstext- Its method, as published.
ketogenictrue/false- True if it is ketogenic.
licensetext- Its license, such as CC BY 3.0.
likesnumber- How many people liked it.
low_fodmaptrue/false- True if it is low FODMAP.
nutritionobject- Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
occasionslist- Occasions it suits, such as christmas.
preparation_minutesnumber- Minutes of preparation.
price_per_serving_centsnumber- What a serving costs, in US cents.
ready_in_minutesnumber- Minutes from start to table.
servingsnumber- How many it serves.
source_nametext- Who published it.
source_urltext- Where it was published.
spoonacular_scorenumber- Spoonacular's overall score, from 0 to 100.
spoonacular_urltext- Its page on spoonacular.com.
stepslist- Its method, step by step.
summarytext- A summary of it, in HTML.
summary_texttext- The summary as plain text.
sustainabletrue/false- True if it is sustainable.
tasteobject- The recipe's taste, each from 0 to 100. Null unless it was asked for.
titletext- Its name.
vegantrue/false- True if it is vegan.
vegetariantrue/false- True if it is vegetarian.
very_healthytrue/false- True if it is very healthy.
very_populartrue/false- True if it is very popular.
weight_watcher_smart_pointsnumber- Its Weight Watchers SmartPoints.
whole30true/false- True if it is Whole30.
wine_pairingobject- Wines that go with the recipe. Null unless it was asked for.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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
texttextRequired - The text to look through.
Outputs
annotationslist- Each food found, in the order mentioned.
countnumber- How many came back.
disheslist- The dishes found, once each.
ingredientslist- The ingredients found, once each.
Example output
{
"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
ingredientslistRequired - The ingredients to cook with, separated by commas, such as apples, flour, sugar.
- Rank by
rankingtext - 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_pantrytrue/false - Optional. Take water, salt, flour and other staples as at hand. On when left empty.Default:
true. - How many
numbernumber - Optional. How many recipes to return, from 1 to 100. 10 when left empty.From 1 to 100.
Outputs
countnumber- How many came back.
recipeslist- The recipes found, the best use of the ingredients first.
Example output
{
"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_caloriesnumber - Optional. The least calories a serving may have.At least 0.
- Maximum calories
max_caloriesnumber - Optional. The most calories a serving may have.At least 0.
- Minimum protein
min_proteinnumber - Optional. The least grams of protein a serving may have.At least 0.
- Maximum protein
max_proteinnumber - Optional. The most grams of protein a serving may have.At least 0.
- Minimum carbohydrates
min_carbsnumber - Optional. The least grams of carbohydrates a serving may have.At least 0.
- Maximum carbohydrates
max_carbsnumber - Optional. The most grams of carbohydrates a serving may have.At least 0.
- Minimum fat
min_fatnumber - Optional. The least grams of fat a serving may have.At least 0.
- Maximum fat
max_fatnumber - Optional. The most grams of fat a serving may have.At least 0.
- More nutrient limits
nutrient_limitsobject - 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
randomtrue/false - Optional. A different random set of matching recipes each time.
- How many
numbernumber - Optional. How many recipes to return, from 1 to 100. 10 when left empty.From 1 to 100.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 900.From 0 to 900.
Outputs
countnumber- How many came back.
recipeslist- The recipes within the limits.
Example output
{
"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_frametext - 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_caloriesnumber - Optional. The calories to aim for each day, such as 2000.At least 1.
- Diet
diettext - 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
excludelist - Optional. Allergens or ingredients to leave out, separated by commas, such as shellfish, olives.
Outputs
countnumber- How many meals the plan has.
dayslist- Each day of the plan.
mealslist- Every meal of the plan, in order.
time_frametext- day or week.
Example output
{
"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_idtextRequired - 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.
aisletext- The supermarket aisle it is found in.
badgeslist- Its badges, such as gluten_free or no_artificial_colors.
breadcrumbslist- Its categories, narrowest first.
creditsobject- Who to credit for the data, when Spoonacular says.
generated_texttext- Spoonacular's description of it.
idnumber- The product's ID.
imagetext- A link to its picture.
image_typetext- The picture's file type.
important_badgeslist- The badges that matter most.
ingredient_countnumber- How many ingredients it has.
ingredient_listtext- Its ingredients, as on the pack.
ingredientslist- Its ingredients.
likesnumber- How many people liked it.
nutritionobject- 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_centsnumber- Its price, in US cents; null when Spoonacular has none.
servingsobject- Its servings.
spoonacular_scorenumber- Spoonacular's score for it, from 0 to 100.
titletext- Its name.
upctext- Its barcode (UPC), when known.
Example output
{
"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_idtextRequired - 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.
badgeslist- Its badges.
breadcrumbslist- Its categories, narrowest first.
generated_texttext- Spoonacular's description of it.
idnumber- The menu item's ID.
imagetext- A link to its picture.
image_typetext- The picture's file type.
likesnumber- How many people liked it.
nutritionobject- Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
pricenumber- Its price, when Spoonacular knows it.
restaurant_chaintext- The chain, such as Burger King.
servingsobject- Its servings.
spoonacular_scorenumber- Spoonacular's score for it, from 0 to 100.
titletext- Its name.
Example output
{
"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
upctextRequired - 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.
aisletext- The supermarket aisle it is found in.
badgeslist- Its badges, such as gluten_free or no_artificial_colors.
breadcrumbslist- Its categories, narrowest first.
creditsobject- Who to credit for the data, when Spoonacular says.
generated_texttext- Spoonacular's description of it.
idnumber- The product's ID.
imagetext- A link to its picture.
image_typetext- The picture's file type.
important_badgeslist- The badges that matter most.
ingredient_countnumber- How many ingredients it has.
ingredient_listtext- Its ingredients, as on the pack.
ingredientslist- Its ingredients.
likesnumber- How many people liked it.
nutritionobject- 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_centsnumber- Its price, in US cents; null when Spoonacular has none.
servingsobject- Its servings.
spoonacular_scorenumber- Spoonacular's score for it, from 0 to 100.
titletext- Its name.
upctext- Its barcode (UPC), when known.
Example output
{
"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
texttext- The joke.
Example output
{
"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_idtextRequired - The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Include taste
include_tastetrue/false - Optional. Add how sweet, salty, sour, bitter, savory, fatty and spicy it is.
- Include a wine pairing
include_wine_pairingtrue/false - Optional. Add wines that go with it, and bottles on sale.
Outputs
A recipe.
cheaptrue/false- True if it is cheap to make.
cooking_minutesnumber- Minutes of cooking.
credits_texttext- Who to credit when showing it.
cuisineslist- Its cuisines, such as italian.
dairy_freetrue/false- True if it is dairy free.
dietslist- The diets it suits, such as gluten free.
dish_typeslist- What kind of dish it is, such as main course.
gapstext- Whether it suits the GAPS diet: no, or a stage.
gluten_freetrue/false- True if it is gluten free.
health_scorenumber- Spoonacular's health score, from 0 to 100.
idnumber- The recipe's ID, which the other recipe actions take. Null for a recipe Spoonacular only read from a page or a step.
imagetext- A link to its picture.
image_typetext- The picture's file type, such as jpg.
ingredientslist- Its ingredients.
instructionstext- Its method, as published.
ketogenictrue/false- True if it is ketogenic.
licensetext- Its license, such as CC BY 3.0.
likesnumber- How many people liked it.
low_fodmaptrue/false- True if it is low FODMAP.
nutritionobject- Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
occasionslist- Occasions it suits, such as christmas.
preparation_minutesnumber- Minutes of preparation.
price_per_serving_centsnumber- What a serving costs, in US cents.
ready_in_minutesnumber- Minutes from start to table.
servingsnumber- How many it serves.
source_nametext- Who published it.
source_urltext- Where it was published.
spoonacular_scorenumber- Spoonacular's overall score, from 0 to 100.
spoonacular_urltext- Its page on spoonacular.com.
stepslist- Its method, step by step.
summarytext- A summary of it, in HTML.
summary_texttext- The summary as plain text.
sustainabletrue/false- True if it is sustainable.
tasteobject- The recipe's taste, each from 0 to 100. Null unless it was asked for.
titletext- Its name.
vegantrue/false- True if it is vegan.
vegetariantrue/false- True if it is vegetarian.
very_healthytrue/false- True if it is very healthy.
very_populartrue/false- True if it is very popular.
weight_watcher_smart_pointsnumber- Its Weight Watchers SmartPoints.
whole30true/false- True if it is Whole30.
wine_pairingobject- Wines that go with the recipe. Null unless it was asked for.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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_idtextRequired - The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
Outputs
countnumber- How many came back.
ingredientslist- Each ingredient's cost.
total_cost_centsnumber- What the whole recipe costs, in US cents.
total_cost_per_serving_centsnumber- What a serving costs, in US cents.
Example output
{
"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
foodtextRequired - A dish, an ingredient or a cuisine, such as steak, salmon or italian.
- Maximum price
max_pricenumber - Optional. The most a recommended bottle may cost, in US dollars.At least 1.
Outputs
paired_wineslist- The kinds of wine that go with it, such as merlot.
pairing_texttext- Why those wines go with it.
product_matcheslist- Wines on sale of the first kind.
Example output
{
"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_idtextRequired - The ingredient's Spoonacular ID, such as 9266 for pineapple. Search ingredients returns it.
- Amount
amountnumber - Optional. How much, such as 150. 1 when left empty.At least 0.
- Unit
unittext - Optional. The amount's unit, such as grams or cups, with an amount.
- Category names in
localetext - 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.
aisletext- The supermarket aisle it is found in.
amountnumber- How much.
category_pathlist- Its categories, narrowest first.
consistencytext- solid or liquid.
estimated_cost_centsnumber- What the amount costs, in US cents.
idnumber- The ingredient's ID.
imagetext- A link to a picture of it.
metalist- Words describing it, such as chopped.
nametext- Its name.
name_cleantext- Its plain name, where it differs.
nutritionobject- Nutrition, per serving. Null unless it was asked for. The main nutrients are fields of their own; every one Spoonacular reported is in nutrients.
originaltext- The line as it was given.
original_nametext- The name as it was given.
possible_unitslist- The units it can be measured in.
shopping_list_unitslist- The units it is bought in.
unittext- The unit, as given.
unit_longtext- The unit, in full.
unit_shorttext- The unit, short.
Example output
{
"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
upctextRequired - The product's barcode number (UPC), such as 041631000564. Spoonacular knows mostly products sold in the US.
Outputs
calorieslist- Comparable products, by calories.
countnumber- How many came back in all.
likeslist- Comparable products, by likes.
pricelist- Comparable products, by price.
proteinlist- Comparable products, by protein.
spoonacular_scorelist- Comparable products, by Spoonacular's score.
sugarlist- Comparable products, by sugar.
Example output
{
"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
winetextRequired - 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
countnumber- How many came back.
disheslist- The dishes that go with it.
texttext- The wine described, and why the dishes go with it.
Example output
{
"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
ingredienttextRequired - The ingredient's name, such as butter, or its ID.
Outputs
countnumber- How many came back.
ingredienttext- The ingredient they replace.
messagetext- Spoonacular's note on what it found.
substituteslist- Each substitute, with how much to use.
Example output
{
"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
texttext- The fact.
Example output
{
"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_tagslist - Optional. Tags every recipe must have, separated by commas: diets, meal types, cuisines or intolerances, such as vegetarian, dessert.
- Without tags
exclude_tagslist - Optional. Tags no recipe may have, separated by commas, such as dairy, quinoa.
- Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- How many
numbernumber - Optional. How many recipes to return, from 1 to 100. 1 when left empty.From 1 to 100.
Outputs
countnumber- How many came back.
recipeslist- The recipes.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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_idtextRequired - The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- Break steps down
step_breakdowntrue/false - Optional. Split long steps into smaller ones.
Outputs
countnumber- How many came back.
equipmentlist- Every piece of equipment the method uses, once each.
ingredientslist- Every ingredient the method uses, once each.
stepslist- The method, step by step, every part in order.
Example output
{
"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_idslistRequired - The recipes' IDs, separated by commas, such as 716429, 715538. The recipes an earlier step found work too.
- Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
Outputs
countnumber- How many came back.
missing_idslist- Any IDs Spoonacular has no recipe for.
recipeslist- The recipes, in no particular order.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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_idtextRequired - The recipe's Spoonacular ID, such as 716429. The recipe searches return it.
- How many
numbernumber - Optional. How many recipes to return, from 1 to 100. 10 when left empty.From 1 to 100.
Outputs
countnumber- How many came back.
recipeslist- The similar recipes.
Example output
{
"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
winetextRequired - 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_pricenumber - Optional. The most a recommended bottle may cost, in US dollars.At least 1.
- Minimum rating
min_ratingnumber - Optional. The lowest rating, from 0 to 1: 0.8 is four stars of five.From 0 to 1.
- How many
numbernumber - Optional. How many wines to return, from 1 to 100. 5 when left empty.From 1 to 100.
Outputs
countnumber- How many came back.
total_resultsnumber- How many there are in all, of which this is one page.
wineslist- The wines, best first.
Example output
{
"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
ingredientslistRequired - The ingredients, separated by commas, such as eggs, bacon.
- Servings
servingsnumber - Optional. How many servings to buy for. 1 when left empty.At least 1.
Outputs
countnumber- How many came back.
ingredientslist- Each ingredient, with products.
Example output
{
"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
ingredientslistRequired - The ingredient lines, one a line, such as 1 cup green tea. Up to 100.
- Servings
servingsnumber - Optional. How many servings the lines make, which nutrition is divided by. 1 when left empty.At least 1.
- Include nutrition
include_nutritiontrue/false - Optional. Add nutrition per serving: calories, protein, fat, carbohydrates and every other nutrient Spoonacular tracks.
- Language
languagetext - Optional. The language the text is in. English when left empty.One of:
en(English),de(German).
Outputs
countnumber- How many came back.
ingredientslist- Each line, read, in order.
Example output
{
"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
querytextRequired - What to search for, such as chicken soup.
- Meal type
meal_typetext - 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
cuisinestext - 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
diettext - 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_ingredientslist - Optional. Ingredients the recipes should use, separated by commas, such as tomato, cheese.
- Without ingredients
exclude_ingredientslist - Optional. Ingredients or kinds of ingredient the recipes must not have, separated by commas, such as eggs, nuts.
- Shortest (seconds)
min_lengthnumber - Optional. The shortest a video may be, in seconds.At least 0.
- Longest (seconds)
max_lengthnumber - Optional. The longest a video may be, in seconds.At least 0.
- How many
numbernumber - Optional. How many videos to return, from 1 to 100. 10 when left empty.From 1 to 100.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 900.From 0 to 900.
Outputs
countnumber- How many came back.
total_resultsnumber- How many there are in all, of which this is one page.
videoslist- The videos found, best first.
Example output
{
"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
querytextRequired - What to search for, such as greek yogurt.
- Minimum calories
min_caloriesnumber - Optional. The least calories a serving may have.At least 0.
- Maximum calories
max_caloriesnumber - Optional. The most calories a serving may have.At least 0.
- Minimum protein
min_proteinnumber - Optional. The least grams of protein a serving may have.At least 0.
- Maximum protein
max_proteinnumber - Optional. The most grams of protein a serving may have.At least 0.
- Minimum carbohydrates
min_carbsnumber - Optional. The least grams of carbohydrates a serving may have.At least 0.
- Maximum carbohydrates
max_carbsnumber - Optional. The most grams of carbohydrates a serving may have.At least 0.
- Minimum fat
min_fatnumber - Optional. The least grams of fat a serving may have.At least 0.
- Maximum fat
max_fatnumber - Optional. The most grams of fat a serving may have.At least 0.
- Add product details
add_product_detailstrue/false - Optional. Each product's badges, ingredients, nutrition and price, for 1 point a product.
- How many
numbernumber - Optional. How many products to return, from 1 to 100. 10 when left empty.From 1 to 100.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 990.From 0 to 990.
Outputs
countnumber- How many came back.
offsetnumber- How many were skipped.
productslist- The products found.
total_resultsnumber- How many there are in all, of which this is one page.
Example output
{
"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
querytextRequired - The ingredient's name, whole or in part, such as banana.
- Intolerances
intolerancestext - 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_percentnumber - Optional. The minimum share of calories from protein, from 0 to 100.From 0 to 100.
- Maximum % protein
max_protein_percentnumber - Optional. The maximum share of calories from protein, from 0 to 100.From 0 to 100.
- Minimum % fat
min_fat_percentnumber - Optional. The minimum share of calories from fat, from 0 to 100.From 0 to 100.
- Maximum % fat
max_fat_percentnumber - Optional. The maximum share of calories from fat, from 0 to 100.From 0 to 100.
- Minimum % carbs
min_carbs_percentnumber - Optional. The minimum share of calories from carbs, from 0 to 100.From 0 to 100.
- Maximum % carbs
max_carbs_percentnumber - Optional. The maximum share of calories from carbs, from 0 to 100.From 0 to 100.
- Add kinds of each
add_childrentrue/false - Optional. Also find kinds of each food found, such as banana chips for banana.
- Add aisle and units
meta_informationtrue/false - Optional. Add each one's supermarket aisle and units.
- Sort by
sorttext - Optional. A nutrient to order them by.One of:
calories,protein,carbohydrates,total-fat(Fat),sugar,fiber,sodium. - Sort direction
sort_directiontext - Optional. Lowest or highest first.One of:
asc(Lowest first),desc(Highest first). - Language
languagetext - Optional. The language the text is in. English when left empty.One of:
en(English),de(German). - How many
numbernumber - Optional. How many ingredients to return, from 1 to 100. 10 when left empty.From 1 to 100.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 990.From 0 to 990.
Outputs
countnumber- How many came back.
ingredientslist- The ingredients found.
offsetnumber- How many were skipped.
total_resultsnumber- How many there are in all, of which this is one page.
Example output
{
"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
querytextRequired - What to search for, such as burger.
- Minimum calories
min_caloriesnumber - Optional. The least calories a serving may have.At least 0.
- Maximum calories
max_caloriesnumber - Optional. The most calories a serving may have.At least 0.
- Minimum protein
min_proteinnumber - Optional. The least grams of protein a serving may have.At least 0.
- Maximum protein
max_proteinnumber - Optional. The most grams of protein a serving may have.At least 0.
- Minimum carbohydrates
min_carbsnumber - Optional. The least grams of carbohydrates a serving may have.At least 0.
- Maximum carbohydrates
max_carbsnumber - Optional. The most grams of carbohydrates a serving may have.At least 0.
- Minimum fat
min_fatnumber - Optional. The least grams of fat a serving may have.At least 0.
- Maximum fat
max_fatnumber - Optional. The most grams of fat a serving may have.At least 0.
- Add menu item details
add_menu_item_detailstrue/false - Optional. Each item's nutrition, badges and description, for 1 point an item.
- How many
numbernumber - Optional. How many menu items to return, from 1 to 10. 10 when left empty.From 1 to 10.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 990.From 0 to 990.
Outputs
countnumber- How many came back.
menu_itemslist- The menu items found.
offsetnumber- How many were skipped.
total_resultsnumber- How many there are in all, of which this is one page.
Example output
{
"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
querytext - Optional. What to search for, in plain words, such as pasta or chicken curry.
- Cuisines
cuisinestext - 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_cuisinestext - 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
dietstext - 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
intolerancestext - 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_typetext - 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_ingredientslist - Optional. Ingredients the recipes should use, separated by commas, such as tomato, cheese.
- Without ingredients
exclude_ingredientslist - Optional. Ingredients or kinds of ingredient the recipes must not have, separated by commas, such as eggs, nuts.
- Equipment
equipmentlist - Optional. Only recipes made with any of this equipment, separated by commas, such as blender, frying pan.
- Title contains
title_matchtext - Optional. Text the recipe's name must contain.
- Ready in at most (minutes)
max_ready_timenumber - Optional. The most minutes a recipe may take, preparation and cooking together.At least 1.
- Minimum servings
min_servingsnumber - Optional. The fewest servings a recipe may make.At least 0.
- Maximum servings
max_servingsnumber - Optional. The most servings a recipe may make.At least 0.
- Minimum calories
min_caloriesnumber - Optional. The least calories a serving may have.At least 0.
- Maximum calories
max_caloriesnumber - Optional. The most calories a serving may have.At least 0.
- Minimum protein
min_proteinnumber - Optional. The least grams of protein a serving may have.At least 0.
- Maximum protein
max_proteinnumber - Optional. The most grams of protein a serving may have.At least 0.
- Minimum carbohydrates
min_carbsnumber - Optional. The least grams of carbohydrates a serving may have.At least 0.
- Maximum carbohydrates
max_carbsnumber - Optional. The most grams of carbohydrates a serving may have.At least 0.
- Minimum fat
min_fatnumber - Optional. The least grams of fat a serving may have.At least 0.
- Maximum fat
max_fatnumber - Optional. The most grams of fat a serving may have.At least 0.
- More nutrient limits
nutrient_limitsobject - 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_requiredtrue/false - Optional. Only recipes with step-by-step instructions.
- Add recipe details
add_recipe_detailstrue/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_nutritiontrue/false - Optional. Each recipe's nutrition per serving too, for 0.025 points a recipe.
- Sort by
sorttext - 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_directiontext - Optional. Lowest or highest first.One of:
asc(Lowest first),desc(Highest first). - How many
numbernumber - Optional. How many recipes to return, from 1 to 100. 10 when left empty.From 1 to 100.
- Skip
offsetnumber - Optional. How many results to skip, for the next page: up to 900.From 0 to 900.
Outputs
countnumber- How many came back.
offsetnumber- How many were skipped.
recipeslist- The recipes found, best first.
total_resultsnumber- How many there are in all, of which this is one page.
Example output
{
"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 <b>19g of protein </b>, <b>20g of fat </b>, and a total of <b>584 calories </b>. For <b>$1.63 per serving </b>, this recipe <b>covers 23% </b> 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 <b>45 minutes </b>. All things considered, we decided this recipe <b>deserves a spoonacular score of 83% </b>. This score is awesome. If you like this recipe, take a look at these similar recipes: <a href=\"https://spoonacular.com/recipes/cauliflower-gratin-with-garlic-breadcrumbs-318375\">Cauliflower Gratin with Garlic Breadcrumbs</a>, < href=\"https://spoonacular.com/recipes/pasta-with-cauliflower-sausage-breadcrumbs-30437\">Pasta With Cauliflower, Sausage, & Breadcrumbs</a>, and <a href=\"https://spoonacular.com/recipes/pasta-with-roasted-cauliflower-parsley-and-breadcrumbs-30738\">Pasta With Roasted Cauliflower, Parsley, And Breadcrumbs</a>.",
"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
}