Compartilhar via


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
Email 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 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

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

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

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

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

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

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'.