Share via

Spoonacular Food (Independent Publisher) (Preview)

  • Reference

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