Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
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 |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Amjed Ayoub |
| URL | https://amjedayoub.github.io/portfolio |
| amjedkayoub@gmail.com |
| Connector Metadata | |
|---|---|
| Publisher | Amjed Ayoub |
| Website | https://spoonacular.com |
| Privacy policy | https://spoonacular.com/terms |
| Categories | Website;Lifestyle and Entertainment |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | The API Key for this api |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| 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
- Operation ID:
- AnalyzeARecipeSearchQuery
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
- Operation ID:
- AnalyzeRecipeInstructions
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 Recipe Search
- Operation ID:
- AutocompleteRecipeSearch
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
- Operation ID:
- ClassifyCuisine
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
- Operation ID:
- ConvertAmounts
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
- Operation ID:
- EquipmentById
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
- Operation ID:
- EquipmentByIdImage
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
- Operation ID:
- EquipmentByIdWidget
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
- Operation ID:
- ExtractRecipeFromWebsite
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
- Operation ID:
- GetAnalyzedRecipeInstructions
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
- Operation ID:
- GetRandomRecipes
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
- Operation ID:
- GetRecipeInformation
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
- Operation ID:
- GetRecipeInformationBulk
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
- Operation ID:
- GetSimilarRecipes
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
- Operation ID:
- GuessNutritionByDishName
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
- Operation ID:
- IngredientsById
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
- Operation ID:
- IngredientsByIdImage
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
- Operation ID:
- IngredientsByIdWidget
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
- Operation ID:
- IngredientsWidget
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
- Operation ID:
- NutritionById
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
- Operation ID:
- PriceBreakdownById
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
- Operation ID:
- PriceBreakdownByIdImage
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
- Operation ID:
- PriceBreakdownByIdWidget
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
- Operation ID:
- PriceBreakdownWidget
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
- Operation ID:
- QuickAnswer
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
- Operation ID:
- RecipeNutritionByIdImage
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
- Operation ID:
- RecipeNutritionByIdWidget
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
- Operation ID:
- RecipeNutritionLabelImage
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
- Operation ID:
- RecipeNutritionLabelWidget
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
- Operation ID:
- RecipeNutritionWidget
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
- Operation ID:
- RecipeTasteByIdWidget
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
- Operation ID:
- RecipeTasteWidget
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
- Operation ID:
- SummarizeRecipe
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
- Operation ID:
- TasteById
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'.