Spoonacular Recipe (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 Recipe makes it possible to search for recipes using natural language queries, such as "gluten free brownies without sugar" or "low fat vegan cupcakes." You can automatically calculate the nutritional information for any recipe, visualize ingredient lists and much more.

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

Analyze a Recipe Search Query

Parse a recipe search query to find out its intention.

Analyze Recipe Instructions

This endpoint allows you to break down instructions into atomic steps. Furthermore, each step will contain the ingredients and equipment required. Additionally, all ingredients and equipment from the recipe's instructions will be extracted independently of the step they're used in.

Autocomplete Recipe Search

Autocomplete a partial input to suggest possible recipe names.

Classify Cuisine

Classify the recipe's cuisine.

Convert Amounts

Convert amounts like "2 cups of flour to grams".

Equipment by ID

Get a recipe's equipment list.

Equipment by ID Image

Visualize a recipe's equipment list as an image.

Equipment by ID Widget

Visualize a recipe's equipment list.

Extract Recipe from Website

This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website.

Get Analyzed Recipe Instructions

Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required.

Get Random Recipes

Find random (popular) recipes. If you need to filter recipes by diet, nutrition etc. you might want to consider using the complex recipe search endpoint and set the sort request parameter to random.

Get Recipe Information

Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc.

Get Recipe Information Bulk

Get information about multiple recipes at once. This is equivalent to calling the Get Recipe Information endpoint multiple times, but faster.

Get Similar Recipes

Find recipes which are similar to the given one.

Guess Nutrition by Dish Name

Estimate the macronutrients of a dish based on its title.

Ingredients by ID

Get a recipe's ingredient list.

Ingredients by ID Image

Visualize a recipe's ingredient list.

Ingredients by ID Widget

Visualize a recipe's ingredient list.

Ingredients Widget

Visualize ingredients of a recipe. You can play around with that endpoint!

Nutrition by ID

Get a recipe's nutrition data.

Price Breakdown by ID

Get a recipe's price breakdown data.

Price Breakdown by ID Image

Visualize a recipe's price breakdown.

Price Breakdown by ID Widget

Visualize a recipe's price breakdown.

Price Breakdown Widget

Visualize the price breakdown of a recipe.

Quick Answer

Answer a nutrition related natural language question.

Recipe Nutrition by ID Image

Visualize a recipe's nutritional information as an image.

Recipe Nutrition by ID Widget

Visualize a recipe's nutritional information as HTML including CSS.

Recipe Nutrition Label Image

Get a recipe's nutrition label as an image.

Recipe Nutrition Label Widget

Get a recipe's nutrition label as an HTML widget.

Recipe Nutrition Widget

Visualize a recipe's nutritional information as HTML including CSS.

Recipe Taste by ID Widget

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Recipe Taste Widget

Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint!

Summarize Recipe

Automatically generate a short description that summarizes key information about the recipe.

Taste by ID

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Analyze a Recipe Search Query

Parse a recipe search query to find out its intention.

Parameters

Name Key Required Type Description
Query
q True string

Search query.

Returns

Name Path Type Description
dishes
dishes array of object

dishes

image
dishes.image string

image

name
dishes.name string

name

ingredients
ingredients array of object

ingredients

image
ingredients.image string

image

include
ingredients.include boolean

include

name
ingredients.name string

name

cuisines
cuisines array of

cuisines

modifiers
modifiers array of

modifiers

Analyze Recipe Instructions

This endpoint allows you to break down instructions into atomic steps. Furthermore, each step will contain the ingredients and equipment required. Additionally, all ingredients and equipment from the recipe's instructions will be extracted independently of the step they're used in.

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
parsedInstructions
parsedInstructions array of object

parsedInstructions

name
parsedInstructions.name string

name

steps
parsedInstructions.steps array of object

steps

number
parsedInstructions.steps.number integer

number

step
parsedInstructions.steps.step string

step

ingredients
parsedInstructions.steps.ingredients array of object

ingredients

id
parsedInstructions.steps.ingredients.id integer

id

name
parsedInstructions.steps.ingredients.name string

name

localizedName
parsedInstructions.steps.ingredients.localizedName string

localizedName

image
parsedInstructions.steps.ingredients.image string

image

equipment
parsedInstructions.steps.equipment array of object

equipment

id
parsedInstructions.steps.equipment.id integer

id

name
parsedInstructions.steps.equipment.name string

name

localizedName
parsedInstructions.steps.equipment.localizedName string

localizedName

image
parsedInstructions.steps.equipment.image string

image

ingredients
ingredients array of object

ingredients

id
ingredients.id integer

id

name
ingredients.name string

name

equipment
equipment array of object

equipment

id
equipment.id integer

id

name
equipment.name string

name

Autocomplete a partial input to suggest possible recipe names.

Parameters

Name Key Required Type Description
Search Query
query True string

The search query.

Number of recipes
number True string

The number of returned recipes.

Returns

Name Path Type Description
array of object
id
id integer

id

title
title string

title

imageType
imageType string

imageType

Classify Cuisine

Classify the recipe's cuisine.

Parameters

Name Key Required Type Description
Content Type
Content-Type True string

The Content Type.

key
key string

key

value
value string

value

Returns

Name Path Type Description
cuisine
cuisine string

cuisine

cuisines
cuisines array of string

cuisines

confidence
confidence integer

confidence

Convert Amounts

Convert amounts like "2 cups of flour to grams".

Parameters

Name Key Required Type Description
Ingredient Name
ingredientName True string

the ingredient name.

Source Amount
sourceAmount True string

the source amount.

Source Unit
sourceUnit True string

the source Unit.

Target Unit
targetUnit True string

the target Unit.

Returns

Name Path Type Description
sourceAmount
sourceAmount float

sourceAmount

sourceUnit
sourceUnit string

sourceUnit

targetAmount
targetAmount float

targetAmount

targetUnit
targetUnit string

targetUnit

answer
answer string

answer

Equipment by ID

Get a recipe's equipment list.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
equipment
equipment array of object

equipment

image
equipment.image string

image

name
equipment.name string

name

Equipment by ID Image

Visualize a recipe's equipment list as an image.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Equipment by ID Widget

Visualize a recipe's equipment list.

Parameters

Name Key Required Type Description
Default Css
defaultCss True string

The defaultCss for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Extract Recipe from Website

This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website.

Parameters

Name Key Required Type Description
URL
url True string

The website for the recipes.

Force Extraction
forceExtraction True string

Forcing extraction.

Analyze
analyze True string

Analyzing.

Include Nutrition
includeNutrition True string

Including Nutrition.

Include Taste
includeTaste True string

Including Taste.

Returns

Name Path Type Description
id
id integer

id

title
title string

title

image
image string

image

imageType
imageType string

imageType

servings
servings integer

servings

readyInMinutes
readyInMinutes integer

readyInMinutes

license
license string

license

sourceName
sourceName string

sourceName

sourceUrl
sourceUrl string

sourceUrl

spoonacularSourceUrl
spoonacularSourceUrl string

spoonacularSourceUrl

aggregateLikes
aggregateLikes integer

aggregateLikes

healthScore
healthScore integer

healthScore

spoonacularScore
spoonacularScore integer

spoonacularScore

pricePerServing
pricePerServing float

pricePerServing

analyzedInstructions
analyzedInstructions array of

analyzedInstructions

cheap
cheap boolean

cheap

creditsText
creditsText string

creditsText

cuisines
cuisines array of

cuisines

dairyFree
dairyFree boolean

dairyFree

diets
diets array of

diets

gaps
gaps string

gaps

glutenFree
glutenFree boolean

glutenFree

instructions
instructions string

instructions

ketogenic
ketogenic boolean

ketogenic

lowFodmap
lowFodmap boolean

lowFodmap

occasions
occasions array of

occasions

sustainable
sustainable boolean

sustainable

vegan
vegan boolean

vegan

vegetarian
vegetarian boolean

vegetarian

veryHealthy
veryHealthy boolean

veryHealthy

veryPopular
veryPopular boolean

veryPopular

whole30
whole30 boolean

whole30

weightWatcherSmartPoints
weightWatcherSmartPoints integer

weightWatcherSmartPoints

dishTypes
dishTypes array of string

dishTypes

extendedIngredients
extendedIngredients array of object

extendedIngredients

aisle
extendedIngredients.aisle string

aisle

amount
extendedIngredients.amount float

amount

consitency
extendedIngredients.consitency string

consitency

id
extendedIngredients.id integer

id

image
extendedIngredients.image string

image

amount
extendedIngredients.measures.metric.amount float

amount

unitLong
extendedIngredients.measures.metric.unitLong string

unitLong

unitShort
extendedIngredients.measures.metric.unitShort string

unitShort

amount
extendedIngredients.measures.us.amount float

amount

unitLong
extendedIngredients.measures.us.unitLong string

unitLong

unitShort
extendedIngredients.measures.us.unitShort string

unitShort

meta
extendedIngredients.meta array of string

meta

name
extendedIngredients.name string

name

original
extendedIngredients.original string

original

originalName
extendedIngredients.originalName string

originalName

unit
extendedIngredients.unit string

unit

summary
summary string

summary

pairedWines
winePairing.pairedWines array of string

pairedWines

pairingText
winePairing.pairingText string

pairingText

productMatches
winePairing.productMatches array of object

productMatches

id
winePairing.productMatches.id integer

id

title
winePairing.productMatches.title string

title

description
winePairing.productMatches.description string

description

price
winePairing.productMatches.price string

price

imageUrl
winePairing.productMatches.imageUrl string

imageUrl

averageRating
winePairing.productMatches.averageRating float

averageRating

ratingCount
winePairing.productMatches.ratingCount integer

ratingCount

score
winePairing.productMatches.score float

score

link
winePairing.productMatches.link string

link

Get Analyzed Recipe Instructions

Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required.

Parameters

Name Key Required Type Description
Step Breakdown
stepBreakdown True string

Step breakdown for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
parsedInstructions
parsedInstructions array of object

parsedInstructions

name
parsedInstructions.name string

name

steps
parsedInstructions.steps array of object

steps

number
parsedInstructions.steps.number integer

number

step
parsedInstructions.steps.step string

step

ingredients
parsedInstructions.steps.ingredients array of object

ingredients

id
parsedInstructions.steps.ingredients.id integer

id

name
parsedInstructions.steps.ingredients.name string

name

localizedName
parsedInstructions.steps.ingredients.localizedName string

localizedName

image
parsedInstructions.steps.ingredients.image string

image

equipment
parsedInstructions.steps.equipment array of object

equipment

id
parsedInstructions.steps.equipment.id integer

id

name
parsedInstructions.steps.equipment.name string

name

localizedName
parsedInstructions.steps.equipment.localizedName string

localizedName

image
parsedInstructions.steps.equipment.image string

image

ingredients
ingredients array of object

ingredients

id
ingredients.id integer

id

name
ingredients.name string

name

equipment
equipment array of object

equipment

id
equipment.id integer

id

name
equipment.name string

name

Get Random Recipes

Find random (popular) recipes. If you need to filter recipes by diet, nutrition etc. you might want to consider using the complex recipe search endpoint and set the sort request parameter to random.

Parameters

Name Key Required Type Description
Limit License
limitLicense True string

Your Limit License.

Tags
tags True string

The tags for the recipe.

Number of recipes
number True string

The number of returned recipes.

Returns

Name Path Type Description
recipes
recipes array of object

recipes

id
recipes.id integer

id

title
recipes.title string

title

image
recipes.image string

image

imageType
recipes.imageType string

imageType

servings
recipes.servings integer

servings

readyInMinutes
recipes.readyInMinutes integer

readyInMinutes

license
recipes.license string

license

sourceName
recipes.sourceName string

sourceName

sourceUrl
recipes.sourceUrl string

sourceUrl

spoonacularSourceUrl
recipes.spoonacularSourceUrl string

spoonacularSourceUrl

aggregateLikes
recipes.aggregateLikes integer

aggregateLikes

healthScore
recipes.healthScore integer

healthScore

spoonacularScore
recipes.spoonacularScore integer

spoonacularScore

pricePerServing
recipes.pricePerServing float

pricePerServing

analyzedInstructions
recipes.analyzedInstructions array of

analyzedInstructions

cheap
recipes.cheap boolean

cheap

creditsText
recipes.creditsText string

creditsText

cuisines
recipes.cuisines array of

cuisines

dairyFree
recipes.dairyFree boolean

dairyFree

diets
recipes.diets array of

diets

gaps
recipes.gaps string

gaps

glutenFree
recipes.glutenFree boolean

glutenFree

instructions
recipes.instructions string

instructions

ketogenic
recipes.ketogenic boolean

ketogenic

lowFodmap
recipes.lowFodmap boolean

lowFodmap

occasions
recipes.occasions array of

occasions

sustainable
recipes.sustainable boolean

sustainable

vegan
recipes.vegan boolean

vegan

vegetarian
recipes.vegetarian boolean

vegetarian

veryHealthy
recipes.veryHealthy boolean

veryHealthy

veryPopular
recipes.veryPopular boolean

veryPopular

whole30
recipes.whole30 boolean

whole30

weightWatcherSmartPoints
recipes.weightWatcherSmartPoints integer

weightWatcherSmartPoints

dishTypes
recipes.dishTypes array of string

dishTypes

extendedIngredients
recipes.extendedIngredients array of object

extendedIngredients

aisle
recipes.extendedIngredients.aisle string

aisle

amount
recipes.extendedIngredients.amount float

amount

consitency
recipes.extendedIngredients.consitency string

consitency

id
recipes.extendedIngredients.id integer

id

image
recipes.extendedIngredients.image string

image

amount
recipes.extendedIngredients.measures.metric.amount float

amount

unitLong
recipes.extendedIngredients.measures.metric.unitLong string

unitLong

unitShort
recipes.extendedIngredients.measures.metric.unitShort string

unitShort

amount
recipes.extendedIngredients.measures.us.amount float

amount

unitLong
recipes.extendedIngredients.measures.us.unitLong string

unitLong

unitShort
recipes.extendedIngredients.measures.us.unitShort string

unitShort

meta
recipes.extendedIngredients.meta array of string

meta

name
recipes.extendedIngredients.name string

name

original
recipes.extendedIngredients.original string

original

originalName
recipes.extendedIngredients.originalName string

originalName

unit
recipes.extendedIngredients.unit string

unit

summary
recipes.summary string

summary

pairedWines
recipes.winePairing.pairedWines array of string

pairedWines

pairingText
recipes.winePairing.pairingText string

pairingText

productMatches
recipes.winePairing.productMatches array of object

productMatches

id
recipes.winePairing.productMatches.id integer

id

title
recipes.winePairing.productMatches.title string

title

description
recipes.winePairing.productMatches.description string

description

price
recipes.winePairing.productMatches.price string

price

imageUrl
recipes.winePairing.productMatches.imageUrl string

imageUrl

averageRating
recipes.winePairing.productMatches.averageRating float

averageRating

ratingCount
recipes.winePairing.productMatches.ratingCount integer

ratingCount

score
recipes.winePairing.productMatches.score float

score

link
recipes.winePairing.productMatches.link string

link

Get Recipe Information

Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc.

Parameters

Name Key Required Type Description
included Nutrition
includeNutrition True string

The included nutrition in the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
id
id integer

id

title
title string

title

image
image string

image

imageType
imageType string

imageType

servings
servings integer

servings

readyInMinutes
readyInMinutes integer

readyInMinutes

license
license string

license

sourceName
sourceName string

sourceName

sourceUrl
sourceUrl string

sourceUrl

spoonacularSourceUrl
spoonacularSourceUrl string

spoonacularSourceUrl

aggregateLikes
aggregateLikes integer

aggregateLikes

healthScore
healthScore integer

healthScore

spoonacularScore
spoonacularScore integer

spoonacularScore

pricePerServing
pricePerServing float

pricePerServing

analyzedInstructions
analyzedInstructions array of

analyzedInstructions

cheap
cheap boolean

cheap

creditsText
creditsText string

creditsText

cuisines
cuisines array of

cuisines

dairyFree
dairyFree boolean

dairyFree

diets
diets array of

diets

gaps
gaps string

gaps

glutenFree
glutenFree boolean

glutenFree

instructions
instructions string

instructions

ketogenic
ketogenic boolean

ketogenic

lowFodmap
lowFodmap boolean

lowFodmap

occasions
occasions array of

occasions

sustainable
sustainable boolean

sustainable

vegan
vegan boolean

vegan

vegetarian
vegetarian boolean

vegetarian

veryHealthy
veryHealthy boolean

veryHealthy

veryPopular
veryPopular boolean

veryPopular

whole30
whole30 boolean

whole30

weightWatcherSmartPoints
weightWatcherSmartPoints integer

weightWatcherSmartPoints

dishTypes
dishTypes array of string

dishTypes

extendedIngredients
extendedIngredients array of object

extendedIngredients

aisle
extendedIngredients.aisle string

aisle

amount
extendedIngredients.amount float

amount

consitency
extendedIngredients.consitency string

consitency

id
extendedIngredients.id integer

id

image
extendedIngredients.image string

image

amount
extendedIngredients.measures.metric.amount float

amount

unitLong
extendedIngredients.measures.metric.unitLong string

unitLong

unitShort
extendedIngredients.measures.metric.unitShort string

unitShort

amount
extendedIngredients.measures.us.amount float

amount

unitLong
extendedIngredients.measures.us.unitLong string

unitLong

unitShort
extendedIngredients.measures.us.unitShort string

unitShort

meta
extendedIngredients.meta array of string

meta

name
extendedIngredients.name string

name

original
extendedIngredients.original string

original

originalName
extendedIngredients.originalName string

originalName

unit
extendedIngredients.unit string

unit

summary
summary string

summary

pairedWines
winePairing.pairedWines array of string

pairedWines

pairingText
winePairing.pairingText string

pairingText

productMatches
winePairing.productMatches array of object

productMatches

id
winePairing.productMatches.id integer

id

title
winePairing.productMatches.title string

title

description
winePairing.productMatches.description string

description

price
winePairing.productMatches.price string

price

imageUrl
winePairing.productMatches.imageUrl string

imageUrl

averageRating
winePairing.productMatches.averageRating float

averageRating

ratingCount
winePairing.productMatches.ratingCount integer

ratingCount

score
winePairing.productMatches.score float

score

link
winePairing.productMatches.link string

link

Get Recipe Information Bulk

Get information about multiple recipes at once. This is equivalent to calling the Get Recipe Information endpoint multiple times, but faster.

Parameters

Name Key Required Type Description
Recipe ID
ids True string

The ID for the recipe.

included Nutrition
includeNutrition True string

The included nutrition in the recipe.

Returns

Name Path Type Description
array of object
id
id integer

id

title
title string

title

image
image string

image

imageType
imageType string

imageType

servings
servings integer

servings

readyInMinutes
readyInMinutes integer

readyInMinutes

license
license string

license

sourceName
sourceName string

sourceName

sourceUrl
sourceUrl string

sourceUrl

spoonacularSourceUrl
spoonacularSourceUrl string

spoonacularSourceUrl

aggregateLikes
aggregateLikes integer

aggregateLikes

healthScore
healthScore integer

healthScore

spoonacularScore
spoonacularScore integer

spoonacularScore

pricePerServing
pricePerServing float

pricePerServing

analyzedInstructions
analyzedInstructions array of

analyzedInstructions

cheap
cheap boolean

cheap

creditsText
creditsText string

creditsText

cuisines
cuisines array of

cuisines

dairyFree
dairyFree boolean

dairyFree

diets
diets array of

diets

gaps
gaps string

gaps

glutenFree
glutenFree boolean

glutenFree

instructions
instructions string

instructions

ketogenic
ketogenic boolean

ketogenic

lowFodmap
lowFodmap boolean

lowFodmap

occasions
occasions array of

occasions

sustainable
sustainable boolean

sustainable

vegan
vegan boolean

vegan

vegetarian
vegetarian boolean

vegetarian

veryHealthy
veryHealthy boolean

veryHealthy

veryPopular
veryPopular boolean

veryPopular

whole30
whole30 boolean

whole30

weightWatcherSmartPoints
weightWatcherSmartPoints integer

weightWatcherSmartPoints

dishTypes
dishTypes array of string

dishTypes

extendedIngredients
extendedIngredients array of object

extendedIngredients

aisle
extendedIngredients.aisle string

aisle

amount
extendedIngredients.amount float

amount

consitency
extendedIngredients.consitency string

consitency

id
extendedIngredients.id integer

id

image
extendedIngredients.image string

image

amount
extendedIngredients.measures.metric.amount float

amount

unitLong
extendedIngredients.measures.metric.unitLong string

unitLong

unitShort
extendedIngredients.measures.metric.unitShort string

unitShort

amount
extendedIngredients.measures.us.amount float

amount

unitLong
extendedIngredients.measures.us.unitLong string

unitLong

unitShort
extendedIngredients.measures.us.unitShort string

unitShort

meta
extendedIngredients.meta array of string

meta

name
extendedIngredients.name string

name

original
extendedIngredients.original string

original

originalName
extendedIngredients.originalName string

originalName

unit
extendedIngredients.unit string

unit

summary
summary string

summary

pairedWines
winePairing.pairedWines array of string

pairedWines

pairingText
winePairing.pairingText string

pairingText

productMatches
winePairing.productMatches array of object

productMatches

id
winePairing.productMatches.id integer

id

title
winePairing.productMatches.title string

title

description
winePairing.productMatches.description string

description

price
winePairing.productMatches.price string

price

imageUrl
winePairing.productMatches.imageUrl string

imageUrl

averageRating
winePairing.productMatches.averageRating float

averageRating

ratingCount
winePairing.productMatches.ratingCount integer

ratingCount

score
winePairing.productMatches.score float

score

link
winePairing.productMatches.link string

link

Get Similar Recipes

Find recipes which are similar to the given one.

Parameters

Name Key Required Type Description
Number of recipes
number True string

Number of returned recipes.

Limit License
limitLicense True string

Your Limit License.

Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
array of object
id
id integer

id

title
title string

title

imageType
imageType string

imageType

readyInMinutes
readyInMinutes integer

readyInMinutes

servings
servings integer

servings

sourceUrl
sourceUrl string

sourceUrl

Guess Nutrition by Dish Name

Estimate the macronutrients of a dish based on its title.

Parameters

Name Key Required Type Description
Title
title True string

Recipe title.

Returns

Name Path Type Description
max
calories.confidenceRange95Percent.max float

max

min
calories.confidenceRange95Percent.min float

min

standardDeviation
calories.standardDeviation float

standardDeviation

unit
calories.unit string

unit

value
calories.value integer

value

max
carbs.confidenceRange95Percent.max float

max

min
carbs.confidenceRange95Percent.min float

min

standardDeviation
carbs.standardDeviation float

standardDeviation

unit
carbs.unit string

unit

value
carbs.value integer

value

max
fat.confidenceRange95Percent.max float

max

min
fat.confidenceRange95Percent.min float

min

standardDeviation
fat.standardDeviation float

standardDeviation

unit
fat.unit string

unit

value
fat.value integer

value

max
protein.confidenceRange95Percent.max float

max

min
protein.confidenceRange95Percent.min float

min

standardDeviation
protein.standardDeviation float

standardDeviation

unit
protein.unit string

unit

value
protein.value integer

value

recipesUsed
recipesUsed integer

recipesUsed

Ingredients by ID

Get a recipe's ingredient list.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
ingredients
ingredients array of object

ingredients

unit
ingredients.amount.metric.unit string

unit

value
ingredients.amount.metric.value float

value

unit
ingredients.amount.us.unit string

unit

value
ingredients.amount.us.value float

value

image
ingredients.image string

image

name
ingredients.name string

name

Ingredients by ID Image

Visualize a recipe's ingredient list.

Parameters

Name Key Required Type Description
Measure
measure True string

The measure for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Ingredients by ID Widget

Visualize a recipe's ingredient list.

Parameters

Name Key Required Type Description
Default Css
defaultCss True string

The defaultCss for the recipe.

Measure
measure True string

The measure for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Ingredients Widget

Visualize ingredients of a recipe. You can play around with that endpoint!

Parameters

Name Key Required Type Description
Language
language True string

Language.

Content Type
Content-Type True string

The Content Type.

key
key string

key

value
value string

value

Returns

response
string

Nutrition by ID

Get a recipe's nutrition data.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
calories
calories string

calories

carbs
carbs string

carbs

fat
fat string

fat

protein
protein string

protein

bad
bad array of object

bad

name
bad.name string

name

amount
bad.amount string

amount

indented
bad.indented boolean

indented

percentOfDailyNeeds
bad.percentOfDailyNeeds float

percentOfDailyNeeds

good
good array of object

good

amount
good.amount string

amount

indented
good.indented boolean

indented

percentOfDailyNeeds
good.percentOfDailyNeeds float

percentOfDailyNeeds

name
good.name string

name

Price Breakdown by ID

Get a recipe's price breakdown data.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
ingredients
ingredients array of object

ingredients

unit
ingredients.amount.metric.unit string

unit

value
ingredients.amount.metric.value float

value

unit
ingredients.amount.us.unit string

unit

value
ingredients.amount.us.value float

value

image
ingredients.image string

image

name
ingredients.name string

name

price
ingredients.price integer

price

totalCost
totalCost float

totalCost

totalCostPerServing
totalCostPerServing float

totalCostPerServing

Price Breakdown by ID Image

Visualize a recipe's price breakdown.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Price Breakdown by ID Widget

Visualize a recipe's price breakdown.

Parameters

Name Key Required Type Description
Default Css
defaultCss True string

The defaultCss for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Price Breakdown Widget

Visualize the price breakdown of a recipe.

Parameters

Name Key Required Type Description
Language
language True string

Language.

Content Type
Content-Type True string

Content-Type

key
key string

key

value
value string

value

Returns

response
string

Quick Answer

Answer a nutrition related natural language question.

Parameters

Name Key Required Type Description
Question
q True string

Your question about nutrition and food.

Returns

Name Path Type Description
answer
answer string

answer

image
image string

image

Recipe Nutrition by ID Image

Visualize a recipe's nutritional information as an image.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Recipe Nutrition by ID Widget

Visualize a recipe's nutritional information as HTML including CSS.

Parameters

Name Key Required Type Description
Default Css
defaultCss True string

The defaultCss for the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Recipe Nutrition Label Image

Get a recipe's nutrition label as an image.

Parameters

Name Key Required Type Description
Show Optional Nutrients
showOptionalNutrients True string

Show the optional nutrients.

Show Zero Values
showZeroValues True string

Show the zero values.

Show Ingredients
showIngredients True string

Show the ingredients.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Recipe Nutrition Label Widget

Get a recipe's nutrition label as an HTML widget.

Parameters

Name Key Required Type Description
Default Css
defaultCss True string

The default Css.

Show Optional Nutrients
showOptionalNutrients True string

Show the optional nutrients.

Show Zero Values
showZeroValues True string

Show the zero values.

Show Ingredients
showIngredients True string

Show the ingredients.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Recipe Nutrition Widget

Visualize a recipe's nutritional information as HTML including CSS.

Parameters

Name Key Required Type Description
Language
language True string

Language.

Content Type
Content-Type True string

Content-Type

key
key string

key

value
value string

value

Returns

response
string

Recipe Taste by ID Widget

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Parameters

Name Key Required Type Description
Normalize
normalize True string

Normalize the recipe.

RGB
rgb True string

The RGB.

Recipe ID
id True string

The ID for the recipe.

Returns

response
string

Recipe Taste Widget

Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint!

Parameters

Name Key Required Type Description
Language
language True string

Language.

Normalize
normalize True string

Normalize.

RGB
rgb True string

The RGB.

Content Type
Content-Type True string

Content-Type

key
key string

key

value
value string

value

Returns

response
string

Summarize Recipe

Automatically generate a short description that summarizes key information about the recipe.

Parameters

Name Key Required Type Description
Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
id
id integer

id

summary
summary string

summary

title
title string

title

Taste by ID

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Parameters

Name Key Required Type Description
Normalize
normalize True string

Normalize the recipe.

Recipe ID
id True string

The ID for the recipe.

Returns

Name Path Type Description
sweetness
sweetness float

sweetness

saltiness
saltiness float

saltiness

sourness
sourness float

sourness

bitterness
bitterness float

bitterness

savoriness
savoriness float

savoriness

fattiness
fattiness integer

fattiness

spiciness
spiciness integer

spiciness

Definitions

string

This is the basic data type 'string'.