Spoonacular Food (Independent Publisher) (Preview)
The spoonacular Nutrition, Recipe, and Food allows you to access over 380,000 recipes, thousands of ingredients, food products, and menu items. Spoonacular Food makes it possible to search for food ingredients using natural language queries.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Amjed Ayoub |
| URL | https://amjedayoub.github.io/portfolio |
| amjedkayoub@gmail.com |
| Connector Metadata | |
|---|---|
| Publisher | Amjed Ayoub |
| Website | https://spoonacular.com |
| Privacy policy | https://spoonacular.com/terms |
| Categories | Website;Lifestyle and Entertainment |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | The API Key for this api |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Autocomplete Ingredient Search |
Autocomplete the entry of an ingredient. |
| Autocomplete Menu Item Search |
Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only. |
| Autocomplete Product Search |
Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only. |
| Compute Ingredient Amount |
Compute the amount you need of a certain ingredient for a certain nutritional goal. For example, how much pineapple do you have to eat to get 10 grams of protein? |
| Conversation Suggests |
This endpoint returns suggestions for things the user can say or ask the chatbot. |
| Detect Food in Text |
Take any text and find all mentions of food contained within it. This task is also called Named Entity Recognition (NER). In this case, the entities are foods. Either dishes, such as pizza or cheeseburger, or ingredients, such as cucumber or almonds. |
| Dish Pairing for Wine |
Find a dish that goes well with a given wine. |
| Get Comparable Products |
Find comparable products to the given one. |
| Get Ingredient Information |
Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle. |
| Get Ingredient Substitutes |
Search for substitutes for a given ingredient. |
| Get Ingredient Substitutes by ID |
Search for substitutes for a given ingredient. |
| Get Menu Item Information |
Use a menu item id to get all available information about a menu item, such as nutrition. |
| Get Product Information |
Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving. |
| Image Analysis by URL |
Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes. |
| Image Classification by URL |
Classify a food image. |
| Ingredient Search |
Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.). |
| Menu Item Nutrition by ID Image |
Visualize a menu item's nutritional information as HTML including CSS. |
| Menu Item Nutrition Label Image |
Visualize a menu item's nutritional label information as an image. |
| Menu Item Nutrition Label Widget |
Visualize a menu item's nutritional label information as HTML including CSS. |
| Product Nutrition by ID Image |
Visualize a product's nutritional information as an image. |
| Product Nutrition by ID Widget |
Visualize a product's nutritional information as HTML including CSS. |
| Product Nutrition Label Image |
Get a product's nutrition label as an image. |
| Product Nutrition Label Widget |
Get a product's nutrition label as an HTML widget. |
| Random Food Joke |
Get a random joke that is related to food. Caution: this is an endpoint for adults! |
| Random Food Trivia |
Returns random food trivia. |
| Search All Food |
Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos. |
| Search Food Videos |
Find recipe and other food related videos. |
| Search Grocery Products |
Search packaged food products, such as frozen pizza or Greek yogurt. |
| Search Grocery Products by UPC |
Get information about a packaged food using its UPC. |
| Search Menu Items |
Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha. |
| Search Site Content |
Search spoonacular's site content. You'll be able to find everything that you could also find using the search suggestions on spoonacular.com. This is a suggest API so you can send partial strings as queries. |
| Wine Description |
Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot". |
| Wine Pairing |
Find a wine that goes well with a food. Food can be a dish name ("steak"), an ingredient name ("salmon"), or a cuisine ("italian"). |
| Wine Recommendation |
Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot". |
Autocomplete Ingredient Search
Autocomplete the entry of an ingredient.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Number
|
number | True | string |
The number. |
|
MetaInformation
|
metaInformation | True | string |
The metaInformation. |
|
Intolerances
|
intolerances | True | string |
The intolerances. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
name
|
name | string |
name |
|
image
|
image | string |
image |
|
id
|
id | integer |
id |
|
aisle
|
aisle | string |
aisle |
|
possibleUnits
|
possibleUnits | array of string |
possibleUnits |
Autocomplete Menu Item Search
Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
results
|
results | array of object |
results |
|
id
|
results.id | integer |
id |
|
title
|
results.title | string |
title |
Autocomplete Product Search
Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
results
|
results | array of object |
results |
|
id
|
results.id | integer |
id |
|
title
|
results.title | string |
title |
Compute Ingredient Amount
Compute the amount you need of a certain ingredient for a certain nutritional goal. For example, how much pineapple do you have to eat to get 10 grams of protein?
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Nutrient
|
nutrient | True | string |
The recipe nutrient. |
|
Target
|
target | True | string |
The target. |
|
Unit
|
unit | True | string |
The unit. |
|
ID
|
id | True | string |
The ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
amount
|
amount | float |
amount |
|
unit
|
unit | string |
unit |
Conversation Suggests
This endpoint returns suggestions for things the user can say or ask the chatbot.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
_
|
suggests._ | array of object |
_ |
|
name
|
suggests._.name | string |
name |
|
words
|
words | array of |
words |
Detect Food in Text
Take any text and find all mentions of food contained within it. This task is also called Named Entity Recognition (NER). In this case, the entities are foods. Either dishes, such as pizza or cheeseburger, or ingredients, such as cucumber or almonds.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Content Type
|
Content-Type | True | string |
Content-Type |
|
key
|
key | string |
key |
|
|
value
|
value | string |
value |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
annotations
|
annotations | array of object |
annotations |
|
annotation
|
annotations.annotation | string |
annotation |
|
image
|
annotations.image | string |
image |
|
tag
|
annotations.tag | string |
tag |
Dish Pairing for Wine
Find a dish that goes well with a given wine.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Wine
|
wine | True | string |
The wine. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
pairings
|
pairings | array of string |
pairings |
|
text
|
text | string |
text |
Get Comparable Products
Find comparable products to the given one.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
upc
|
upc | True | string |
The upc. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
calories
|
comparableProducts.calories | array of |
calories |
|
likes
|
comparableProducts.likes | array of |
likes |
|
price
|
comparableProducts.price | array of |
price |
|
protein
|
comparableProducts.protein | array of object |
protein |
|
difference
|
comparableProducts.protein.difference | integer |
difference |
|
id
|
comparableProducts.protein.id | integer |
id |
|
image
|
comparableProducts.protein.image | string |
image |
|
title
|
comparableProducts.protein.title | string |
title |
|
spoonacularScore
|
comparableProducts.spoonacularScore | array of object |
spoonacularScore |
|
difference
|
comparableProducts.spoonacularScore.difference | integer |
difference |
|
id
|
comparableProducts.spoonacularScore.id | integer |
id |
|
image
|
comparableProducts.spoonacularScore.image | string |
image |
|
title
|
comparableProducts.spoonacularScore.title | string |
title |
|
sugar
|
comparableProducts.sugar | array of |
sugar |
Get Ingredient Information
Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Amount
|
amount | True | string |
The amount. |
|
Unit
|
unit | True | string |
The unit. |
|
ID
|
id | True | string |
The ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
original
|
original | string |
original |
|
originalName
|
originalName | string |
originalName |
|
name
|
name | string |
name |
|
nameClean
|
nameClean | string |
nameClean |
|
amount
|
amount | integer |
amount |
|
unit
|
unit | string |
unit |
|
unitShort
|
unitShort | string |
unitShort |
|
unitLong
|
unitLong | string |
unitLong |
|
possibleUnits
|
possibleUnits | array of string |
possibleUnits |
|
value
|
estimatedCost.value | integer |
value |
|
unit
|
estimatedCost.unit | string |
unit |
|
consistency
|
consistency | string |
consistency |
|
shoppingListUnits
|
shoppingListUnits | array of string |
shoppingListUnits |
|
aisle
|
aisle | string |
aisle |
|
image
|
image | string |
image |
|
meta
|
meta | array of |
meta |
|
nutrients
|
nutrition.nutrients | array of object |
nutrients |
|
name
|
nutrition.nutrients.name | string |
name |
|
amount
|
nutrition.nutrients.amount | float |
amount |
|
unit
|
nutrition.nutrients.unit | string |
unit |
|
percentOfDailyNeeds
|
nutrition.nutrients.percentOfDailyNeeds | float |
percentOfDailyNeeds |
|
properties
|
nutrition.properties | array of object |
properties |
|
name
|
nutrition.properties.name | string |
name |
|
amount
|
nutrition.properties.amount | float |
amount |
|
unit
|
nutrition.properties.unit | string |
unit |
|
percentProtein
|
nutrition.caloricBreakdown.percentProtein | float |
percentProtein |
|
percentFat
|
nutrition.caloricBreakdown.percentFat | float |
percentFat |
|
percentCarbs
|
nutrition.caloricBreakdown.percentCarbs | float |
percentCarbs |
|
amount
|
nutrition.weightPerServing.amount | integer |
amount |
|
unit
|
nutrition.weightPerServing.unit | string |
unit |
|
categoryPath
|
categoryPath | array of string |
categoryPath |
Get Ingredient Substitutes
Search for substitutes for a given ingredient.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Ingredient Name
|
ingredientName | True | string |
The ingredient name. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
ingredient
|
ingredient | string |
ingredient |
|
substitutes
|
substitutes | array of string |
substitutes |
|
message
|
message | string |
message |
Get Ingredient Substitutes by ID
Search for substitutes for a given ingredient.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
The ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
ingredient
|
ingredient | string |
ingredient |
|
substitutes
|
substitutes | array of string |
substitutes |
|
message
|
message | string |
message |
Get Menu Item Information
Use a menu item id to get all available information about a menu item, such as nutrition.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
The ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
title
|
title | string |
title |
|
restaurantChain
|
restaurantChain | string |
restaurantChain |
|
nutrients
|
nutrition.nutrients | array of object |
nutrients |
|
name
|
nutrition.nutrients.name | string |
name |
|
amount
|
nutrition.nutrients.amount | integer |
amount |
|
unit
|
nutrition.nutrients.unit | string |
unit |
|
percentOfDailyNeeds
|
nutrition.nutrients.percentOfDailyNeeds | integer |
percentOfDailyNeeds |
|
percentProtein
|
nutrition.caloricBreakdown.percentProtein | integer |
percentProtein |
|
percentFat
|
nutrition.caloricBreakdown.percentFat | integer |
percentFat |
|
percentCarbs
|
nutrition.caloricBreakdown.percentCarbs | integer |
percentCarbs |
|
badges
|
badges | array of |
badges |
|
breadcrumbs
|
breadcrumbs | array of string |
breadcrumbs |
|
generatedText
|
generatedText | string |
generatedText |
|
imageType
|
imageType | string |
imageType |
|
likes
|
likes | integer |
likes |
|
number
|
servings.number | integer |
number |
|
size
|
servings.size | integer |
size |
|
unit
|
servings.unit | string |
unit |
|
price
|
price | float |
price |
|
spoonacularScore
|
spoonacularScore | float |
spoonacularScore |
Get Product Information
Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
The ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
title
|
title | string |
title |
|
breadcrumbs
|
breadcrumbs | array of string |
breadcrumbs |
|
imageType
|
imageType | string |
imageType |
|
badges
|
badges | array of string |
badges |
|
importantBadges
|
importantBadges | array of string |
importantBadges |
|
ingredientCount
|
ingredientCount | integer |
ingredientCount |
|
generatedText
|
generatedText | string |
generatedText |
|
ingredientList
|
ingredientList | string |
ingredientList |
|
ingredients
|
ingredients | array of object |
ingredients |
|
description
|
ingredients.description | string |
description |
|
name
|
ingredients.name | string |
name |
|
safety_level
|
ingredients.safety_level | string |
safety_level |
|
likes
|
likes | integer |
likes |
|
aisle
|
aisle | string |
aisle |
|
nutrients
|
nutrition.nutrients | array of object |
nutrients |
|
name
|
nutrition.nutrients.name | string |
name |
|
amount
|
nutrition.nutrients.amount | integer |
amount |
|
unit
|
nutrition.nutrients.unit | string |
unit |
|
percentOfDailyNeeds
|
nutrition.nutrients.percentOfDailyNeeds | float |
percentOfDailyNeeds |
|
percentProtein
|
nutrition.caloricBreakdown.percentProtein | float |
percentProtein |
|
percentFat
|
nutrition.caloricBreakdown.percentFat | integer |
percentFat |
|
percentCarbs
|
nutrition.caloricBreakdown.percentCarbs | float |
percentCarbs |
|
price
|
price | integer |
price |
|
number
|
servings.number | integer |
number |
|
size
|
servings.size | integer |
size |
|
unit
|
servings.unit | string |
unit |
|
spoonacularScore
|
spoonacularScore | integer |
spoonacularScore |
Image Analysis by URL
Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Url
|
imageUrl | True | string |
The image Url. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
recipesUsed
|
nutrition.recipesUsed | integer |
recipesUsed |
|
value
|
nutrition.calories.value | integer |
value |
|
unit
|
nutrition.calories.unit | string |
unit |
|
min
|
nutrition.calories.confidenceRange95Percent.min | float |
min |
|
max
|
nutrition.calories.confidenceRange95Percent.max | float |
max |
|
standardDeviation
|
nutrition.calories.standardDeviation | float |
standardDeviation |
|
value
|
nutrition.fat.value | integer |
value |
|
unit
|
nutrition.fat.unit | string |
unit |
|
min
|
nutrition.fat.confidenceRange95Percent.min | float |
min |
|
max
|
nutrition.fat.confidenceRange95Percent.max | float |
max |
|
standardDeviation
|
nutrition.fat.standardDeviation | float |
standardDeviation |
|
value
|
nutrition.protein.value | integer |
value |
|
unit
|
nutrition.protein.unit | string |
unit |
|
min
|
nutrition.protein.confidenceRange95Percent.min | float |
min |
|
max
|
nutrition.protein.confidenceRange95Percent.max | float |
max |
|
standardDeviation
|
nutrition.protein.standardDeviation | float |
standardDeviation |
|
value
|
nutrition.carbs.value | integer |
value |
|
unit
|
nutrition.carbs.unit | string |
unit |
|
min
|
nutrition.carbs.confidenceRange95Percent.min | float |
min |
|
max
|
nutrition.carbs.confidenceRange95Percent.max | float |
max |
|
standardDeviation
|
nutrition.carbs.standardDeviation | float |
standardDeviation |
|
name
|
category.name | string |
name |
|
probability
|
category.probability | float |
probability |
|
recipes
|
recipes | array of object |
recipes |
|
id
|
recipes.id | integer |
id |
|
title
|
recipes.title | string |
title |
|
imageType
|
recipes.imageType | string |
imageType |
|
url
|
recipes.url | string |
url |
Image Classification by URL
Classify a food image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Url
|
imageUrl | True | string |
The image Url. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
category
|
category | string |
category |
|
probability
|
probability | float |
probability |
Ingredient Search
Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
addChildren
|
addChildren | True | string |
addChildren. |
|
Min Protein Percent
|
minProteinPercent | True | string |
The min Protein Percent. |
|
Max Protein Percent
|
maxProteinPercent | True | string |
The max Protein Percent. |
|
Min Fat Percent
|
minFatPercent | True | string |
The min Fat Percent. |
|
Max Fat Percent
|
maxFatPercent | True | string |
The max Fat Percent. |
|
Min Carbs Percent
|
minCarbsPercent | True | string |
The min Carbs Percent. |
|
Max Carbs Percent
|
maxCarbsPercent | True | string |
The max Carbs Percent. |
|
MetaInformation
|
metaInformation | True | string |
The metaInformation. |
|
Intolerances
|
intolerances | True | string |
The intolerances. |
|
Sort
|
sort | True | string |
Sort. |
|
Sort Direction
|
sortDirection | True | string |
Sort Direction. |
|
offset
|
offset | True | string |
offset. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
results
|
results | array of object |
results |
|
id
|
results.id | integer |
id |
|
name
|
results.name | string |
name |
|
image
|
results.image | string |
image |
|
offset
|
offset | integer |
offset |
|
number
|
number | integer |
number |
|
totalResults
|
totalResults | integer |
totalResults |
Menu Item Nutrition by ID Image
Visualize a menu item's nutritional information as HTML including CSS.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Menu Item Nutrition Label Image
Visualize a menu item's nutritional label information as an image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Show Optional Nutrients
|
showOptionalNutrients | True | string |
Show Optional Nutrients. |
|
Show Zero Values
|
showZeroValues | True | string |
Show Zero Values. |
|
Show Ingredients
|
showIngredients | True | string |
Show Ingredients. |
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Menu Item Nutrition Label Widget
Visualize a menu item's nutritional label information as HTML including CSS.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
DefaultCss
|
defaultCss | True | string |
The defaultCss. |
|
Show Optional Nutrients
|
showOptionalNutrients | True | string |
Show Optional Nutrients. |
|
Show Zero Values
|
showZeroValues | True | string |
Show Zero Values. |
|
Show Ingredients
|
showIngredients | True | string |
Show Ingredients. |
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Product Nutrition by ID Image
Visualize a product's nutritional information as an image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Product Nutrition by ID Widget
Visualize a product's nutritional information as HTML including CSS.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
DefaultCss
|
defaultCss | True | string |
The defaultCss. |
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Product Nutrition Label Image
Get a product's nutrition label as an image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Show Optional Nutrients
|
showOptionalNutrients | True | string |
Show Optional Nutrients. |
|
Show Zero Values
|
showZeroValues | True | string |
Show Zero Values. |
|
Show Ingredients
|
showIngredients | True | string |
Show Ingredients. |
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Product Nutrition Label Widget
Get a product's nutrition label as an HTML widget.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
DefaultCss
|
defaultCss | True | string |
The defaultCss. |
|
Show Optional Nutrients
|
showOptionalNutrients | True | string |
Show Optional Nutrients. |
|
Show Zero Values
|
showZeroValues | True | string |
Show Zero Values. |
|
Show Ingredients
|
showIngredients | True | string |
Show Ingredients. |
|
ID
|
id | True | string |
The ID. |
Returns
- response
- string
Random Food Joke
Get a random joke that is related to food. Caution: this is an endpoint for adults!
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
text
|
text | string |
text |
Random Food Trivia
Returns random food trivia.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
text
|
text | string |
text |
Search All Food
Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
offset
|
offset | True | string |
offset. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
query
|
query | string |
query |
|
totalResults
|
totalResults | integer |
totalResults |
|
limit
|
limit | integer |
limit |
|
offset
|
offset | integer |
offset |
|
searchResults
|
searchResults | array of object |
searchResults |
|
name
|
searchResults.name | string |
name |
|
totalResults
|
searchResults.totalResults | integer |
totalResults |
|
results
|
searchResults.results | array of object |
results |
|
id
|
searchResults.results.id | string |
id |
|
name
|
searchResults.results.name | string |
name |
|
image
|
searchResults.results.image | string |
image |
|
link
|
searchResults.results.link | string |
link |
|
type
|
searchResults.results.type | string |
type |
|
relevance
|
searchResults.results.relevance | integer |
relevance |
|
content
|
searchResults.results.content | string |
content |
Search Food Videos
Find recipe and other food related videos.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Type
|
type | True | string |
The type. |
|
Cuisine
|
cuisine | True | string |
The cuisine. |
|
Diet
|
diet | True | string |
The diet. |
|
Included Ingredients
|
includeIngredients | True | string |
The included Ingredients. |
|
Excluded Ingredients
|
excludeIngredients | True | string |
The excluded Ingredients. |
|
Min Length
|
minLength | True | string |
The min length. |
|
Max Length
|
maxLength | True | string |
The max length. |
|
offset
|
offset | True | string |
offset. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
videos
|
videos | array of object |
videos |
|
title
|
videos.title | string |
title |
|
length
|
videos.length | integer |
length |
|
rating
|
videos.rating | integer |
rating |
|
shortTitle
|
videos.shortTitle | string |
shortTitle |
|
thumbnail
|
videos.thumbnail | string |
thumbnail |
|
views
|
videos.views | integer |
views |
|
youTubeId
|
videos.youTubeId | string |
youTubeId |
|
totalResults
|
totalResults | integer |
totalResults |
Search Grocery Products
Search packaged food products, such as frozen pizza or Greek yogurt.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Min Calories
|
minCalories | True | string |
The min calories. |
|
Max Calories
|
maxCalories | True | string |
The max calories. |
|
Min Carbs
|
minCarbs | True | string |
The min Carbs. |
|
Max Carbs
|
maxCarbs | True | string |
The max Carbs. |
|
Min Protein
|
minProtein | True | string |
The min Protein. |
|
Max Protein
|
maxProtein | True | string |
The max Protein. |
|
Min Fat
|
minFat | True | string |
The min Fat. |
|
Max Fat
|
maxFat | True | string |
The max Fat. |
|
offset
|
offset | True | string |
offset. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
products
|
products | array of object |
products |
|
id
|
products.id | integer |
id |
|
title
|
products.title | string |
title |
|
imageType
|
products.imageType | string |
imageType |
|
totalProducts
|
totalProducts | integer |
totalProducts |
|
type
|
type | string |
type |
|
offset
|
offset | integer |
offset |
|
number
|
number | integer |
number |
Search Grocery Products by UPC
Get information about a packaged food using its UPC.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
upc
|
upc | True | string |
The upc. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
title
|
title | string |
title |
|
badges
|
badges | array of string |
badges |
|
importantBadges
|
importantBadges | array of string |
importantBadges |
|
breadcrumbs
|
breadcrumbs | array of string |
breadcrumbs |
|
generatedText
|
generatedText | string |
generatedText |
|
imageType
|
imageType | string |
imageType |
|
ingredientCount
|
ingredientCount | integer |
ingredientCount |
|
ingredientList
|
ingredientList | string |
ingredientList |
|
ingredients
|
ingredients | array of object |
ingredients |
|
description
|
ingredients.description | string |
description |
|
name
|
ingredients.name | string |
name |
|
safety_level
|
ingredients.safety_level | string |
safety_level |
|
likes
|
likes | integer |
likes |
|
nutrients
|
nutrition.nutrients | array of object |
nutrients |
|
name
|
nutrition.nutrients.name | string |
name |
|
amount
|
nutrition.nutrients.amount | integer |
amount |
|
unit
|
nutrition.nutrients.unit | string |
unit |
|
percentOfDailyNeeds
|
nutrition.nutrients.percentOfDailyNeeds | float |
percentOfDailyNeeds |
|
percentProtein
|
nutrition.caloricBreakdown.percentProtein | float |
percentProtein |
|
percentFat
|
nutrition.caloricBreakdown.percentFat | integer |
percentFat |
|
percentCarbs
|
nutrition.caloricBreakdown.percentCarbs | float |
percentCarbs |
|
price
|
price | integer |
price |
|
number
|
servings.number | integer |
number |
|
size
|
servings.size | integer |
size |
|
unit
|
servings.unit | string |
unit |
|
spoonacularScore
|
spoonacularScore | integer |
spoonacularScore |
Search Menu Items
Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
|
Min Calories
|
minCalories | True | string |
The min calories. |
|
Max Calories
|
maxCalories | True | string |
The max calories. |
|
Min Carbs
|
minCarbs | True | string |
The min Carbs. |
|
Max Carbs
|
maxCarbs | True | string |
The max Carbs. |
|
Min Protein
|
minProtein | True | string |
The min Protein. |
|
Max Protein
|
maxProtein | True | string |
The max Protein. |
|
Min Fat
|
minFat | True | string |
The min fat. |
|
Max Fat
|
maxFat | True | string |
The max fat. |
|
offset
|
offset | True | string |
offset. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
menuItems
|
menuItems | array of object |
menuItems |
|
id
|
menuItems.id | integer |
id |
|
title
|
menuItems.title | string |
title |
|
restaurantChain
|
menuItems.restaurantChain | string |
restaurantChain |
|
image
|
menuItems.image | string |
image |
|
imageType
|
menuItems.imageType | string |
imageType |
|
number
|
menuItems.servings.number | integer |
number |
|
size
|
menuItems.servings.size | integer |
size |
|
unit
|
menuItems.servings.unit | string |
unit |
|
totalMenuItems
|
totalMenuItems | integer |
totalMenuItems |
|
type
|
type | string |
type |
|
offset
|
offset | integer |
offset |
|
number
|
number | integer |
number |
Search Site Content
Search spoonacular's site content. You'll be able to find everything that you could also find using the search suggestions on spoonacular.com. This is a suggest API so you can send partial strings as queries.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
The Query. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Articles
|
Articles | array of object |
Articles |
|
dataPoints
|
Articles.dataPoints | array of |
dataPoints |
|
image
|
Articles.image | string |
image |
|
link
|
Articles.link | string |
link |
|
name
|
Articles.name | string |
name |
|
Grocery Products
|
Grocery Products | array of object |
Grocery Products |
|
dataPoints
|
Grocery Products.dataPoints | array of object |
dataPoints |
|
key
|
Grocery Products.dataPoints.key | string |
key |
|
value
|
Grocery Products.dataPoints.value | string |
value |
|
image
|
Grocery Products.image | string |
image |
|
link
|
Grocery Products.link | string |
link |
|
name
|
Grocery Products.name | string |
name |
|
Menu Items
|
Menu Items | array of object |
Menu Items |
|
dataPoints
|
Menu Items.dataPoints | array of object |
dataPoints |
|
key
|
Menu Items.dataPoints.key | string |
key |
|
value
|
Menu Items.dataPoints.value | string |
value |
|
image
|
Menu Items.image | string |
image |
|
link
|
Menu Items.link | string |
link |
|
name
|
Menu Items.name | string |
name |
|
Recipes
|
Recipes | array of object |
Recipes |
|
dataPoints
|
Recipes.dataPoints | array of object |
dataPoints |
|
key
|
Recipes.dataPoints.key | string |
key |
|
value
|
Recipes.dataPoints.value | string |
value |
|
image
|
Recipes.image | string |
image |
|
link
|
Recipes.link | string |
link |
|
name
|
Recipes.name | string |
name |
Wine Description
Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot".
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Wine
|
wine | True | string |
The wine. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
wineDescription
|
wineDescription | string |
wineDescription |
Wine Pairing
Find a wine that goes well with a food. Food can be a dish name ("steak"), an ingredient name ("salmon"), or a cuisine ("italian").
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Food
|
food | True | string |
The food. |
|
Max Price
|
maxPrice | True | string |
The max price. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
pairedWines
|
pairedWines | array of string |
pairedWines |
|
pairingText
|
pairingText | string |
pairingText |
|
productMatches
|
productMatches | array of object |
productMatches |
|
id
|
productMatches.id | integer |
id |
|
title
|
productMatches.title | string |
title |
|
averageRating
|
productMatches.averageRating | integer |
averageRating |
|
description
|
productMatches.description | string |
description |
|
imageUrl
|
productMatches.imageUrl | string |
imageUrl |
|
link
|
productMatches.link | string |
link |
|
price
|
productMatches.price | string |
price |
|
ratingCount
|
productMatches.ratingCount | integer |
ratingCount |
|
score
|
productMatches.score | float |
score |
Wine Recommendation
Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot".
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Wine
|
wine | True | string |
The wine. |
|
Max Price
|
maxPrice | True | string |
The max price. |
|
Min Rating
|
minRating | True | string |
The min rating. |
|
Number
|
number | True | string |
The number. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
recommendedWines
|
recommendedWines | array of object |
recommendedWines |
|
id
|
recommendedWines.id | integer |
id |
|
title
|
recommendedWines.title | string |
title |
|
averageRating
|
recommendedWines.averageRating | float |
averageRating |
|
description
|
recommendedWines.description | string |
description |
|
imageUrl
|
recommendedWines.imageUrl | string |
imageUrl |
|
link
|
recommendedWines.link | string |
link |
|
price
|
recommendedWines.price | string |
price |
|
ratingCount
|
recommendedWines.ratingCount | integer |
ratingCount |
|
score
|
recommendedWines.score | float |
score |
|
totalFound
|
totalFound | integer |
totalFound |
Definitions
string
This is the basic data type 'string'.