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