Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
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 |
|---|---|---|
| Copilot Studio | 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) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
| 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) |
| 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
- Operation ID:
- AutocompleteIngredientSearch
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
- Operation ID:
- AutocompleteMenuItemSearch
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
- Operation ID:
- AutocompleteProductSearch
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
- Operation ID:
- ComputeIngredientAmount
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
- Operation ID:
- ConversationSuggests
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
- Operation ID:
- DetectFoodInText
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
- Operation ID:
- DishPairingForWine
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
- Operation ID:
- GetComparableProducts
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
- Operation ID:
- GetIngredientInformation
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
- Operation ID:
- GetIngredientSubstitutes
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
- Operation ID:
- GetIngredientSubstitutesById
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
- Operation ID:
- GetMenuItemInformation
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
- Operation ID:
- GetProductInformation
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
- Operation ID:
- ImageAnalysisByUrl
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
- Operation ID:
- ImageClassificationByUrl
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
- Operation ID:
- IngredientSearch
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
- Operation ID:
- MenuItemNutritionByIdImage
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
- Operation ID:
- MenuItemNutritionLabelImage
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
- Operation ID:
- MenuItemNutritionLabelWidget
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
- Operation ID:
- ProductNutritionByIdImage
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
- Operation ID:
- ProductNutritionByIdWidget
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
- Operation ID:
- ProductNutritionLabelImage
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
- Operation ID:
- ProductNutritionLabelWidget
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
- Operation ID:
- RandomFoodJoke
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
- Operation ID:
- RandomFoodTrivia
Returns random food trivia.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
text
|
text | string |
text |
Search All Food
- Operation ID:
- SearchAllFood
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
- Operation ID:
- SearchFoodVideos
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
- Operation ID:
- SearchGroceryProducts
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
- Operation ID:
- SearchGroceryProductsByUpc
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
- Operation ID:
- SearchMenuItems
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
- Operation ID:
- SearchSiteContent
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
- Operation ID:
- WineDescription
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
- Operation ID:
- WinePairing
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
- Operation ID:
- WineRecommendation
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'.