Recipe - Food - Nutrition

FREEMIUM
By spoonacular
Updated 8 months ago
Food
9.9/10
Popularity Score
486ms
Latency
97%
Success Rate

Recipe - Food - Nutrition API Documentation

The spoonacular Nutrition, Recipe, and Food API allows you to access over 365,000 recipes and 86,000 food products. Our food ontology and semantic recipe search engine 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, analyze recipe costs, visualize ingredient lists, find recipes for what's in your fridge, find recipes based on special diets, nutritional requirements, or favorite ingredients, classify recipes into types and cuisines, convert ingredient amounts, or even compute an entire meal plan. With our powerful API, you can create many kinds of food and especially nutrition apps.

Special diets/dietary requirements currently available include: vegan, vegetarian, pescetarian, gluten free, grain free, dairy free, high protein, low sodium, low carb, Paleo, Primal, ketogenic, FODMAP, and Whole 30. We will soon be adding Weight Watcher points, too.

View API Details
Compute
GETQuick Answer
POSTClassify Cuisine
GETMatch Recipes to Daily Calories
POSTCreate Recipe Card
POSTVisualize Ingredients
POSTVisualize Recipe Nutrition
POSTVisualize Price Breakdown
GETSummarize Recipe
POSTClassify a Grocery Product
POSTClassify Grocery Products (Batch)
POSTMap Ingredients to Grocery Products
POSTVisualize Equipment
GETConvert Amounts
GETGenerate Meal Plan
GETVisualize Product Nutrition
GETVisualize Menu Item Nutrition
GETVisualize Recipe Nutrition by id
GETGuess Nutrition by Dish Name
GETVisualize Recipe Ingredients by id
GETVisualize Recipe Equipment by id
GETVisualize Recipe Price Breakdown by id
Extract
GETExtract Recipe from Website
POSTParse Ingredients
GETAnalyze a Recipe Search Query
POSTAnalyze Recipe Instructions
POSTDetect Food in Text
Search
GETSearch Recipes
GETSearch Recipes by Ingredients
GETSearch Recipes by Nutrients
GETGet Similar Recipes
GETSearch Grocery Products
GETAutocomplete Ingredient Search
GETSearch Recipes Complex
GETAutocomplete Recipe Search
GETGet Random Recipes
GETSearch Site Content
GETSearch Grocery Products by UPC
GETGet Ingredient Substitutes by Id
GETGet Ingredient Substitutes
GETSearch Food Videos
GETSearch Menu Items
GETGet Comparable Products
GETGet Wine Pairing
GETGet Dish Pairing for Wine
GETGet Wine Description
GETGet Wine Recommendation
GETAutocomplete Menu Item Search
GETAutocomplete Product Search
GETRecipe Complex Search
Data
GETGet Recipe Information
GETGet Product Information
GETGet Analyzed Recipe Instructions
GETGet a Random Food Joke
GETGet Random Food Trivia
GETGet Food Information
GETGet Recipe Information Bulk
GETGet Menu Item Information
GETGet Recipe Equipment by id
GETGet Recipe Price Breakdown by id
GETGet Recipe Ingredients by id
GETGet Recipe Nutrition by id
Chat
GETTalk to a chatbot
GETGet Conversation Suggests
GETRecipe Complex Search

Search through hundreds of thousands of recipes using advanced filtering and ranking. NOTE: Since this method combines three other functionalities, each request counts as 3 requests.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Optional Parameters
minAlcoholNUMBER
OPTIONALThe minimum number of grams of alcohol the recipe must have.
maxVitaminB2NUMBER
OPTIONALThe maximum number of milligrams of Vitamin B2 the recipe can have.
minVitaminB6NUMBER
OPTIONALThe minimum number of milligrams of Vitamin B6 the recipe must have.
maxFolicAcidNUMBER
OPTIONALThe maximum number of micrograms of folic acid the recipe can have.
minCaloriesNUMBER
OPTIONALThe minimum number of calories the recipe must have.
addRecipeInformationBOOLEAN
OPTIONALIf set to true, you get more information about the recipes returned. This saves the calls to get recipe information.
excludeIngredientsSTRING
OPTIONALAn comma-separated list of ingredients that must not be contained in the recipes.
maxVitaminB6NUMBER
OPTIONALThe maximum number of milligrams of Vitamin B6 the recipe can have.
maxVitaminB1NUMBER
OPTIONALThe maximum number of milligrams of Vitamin B1 the recipe can have.
maxPotassiumNUMBER
OPTIONALThe maxnimum number of milligrams of potassium the recipe can have.
minPotassiumNUMBER
OPTIONALThe minimum number of milligrams of potassium the recipe must have.
maxPhosphorusNUMBER
OPTIONALThe maximum number of milligrams of phosphorus the recipe can have.
minVitaminENUMBER
OPTIONALThe minimum number of milligrams of Vitamin E the recipe must have.
maxSodiumNUMBER
OPTIONALThe maximum number of milligrams of sodium the recipe can have.
maxCarbsNUMBER
OPTIONALThe maximum number of grams of carbohydrates the recipe can have.
minCholineNUMBER
OPTIONALThe minimum number of milligrams of choline the recipe must have.
titleMatchSTRING
OPTIONALA string that the recipes must contain in their titles.
intolerancesSTRING
OPTIONALA comma-separated list of intolerances. All found recipes must not have ingredients that could cause problems for people with one of the given tolerances. Possible values are: dairy, egg, gluten, peanut, sesame, seafood, shellfish, soy, sulfite, tree nut, and wheat.
minIronNUMBER
OPTIONALThe minimum number of milligrams of iron the recipe must have.
numberNUMBER
OPTIONALThe number of results to return (between 1 and 100).
minCaffeineNUMBER
OPTIONALThe minimum number of milligrams of caffeine the recipe must have.
maxFatNUMBER
OPTIONALThe maximum number of grams of fat the recipe can have.
minVitaminB12NUMBER
OPTIONALThe minimum number of micrograms of Vitamin B12 the recipe must have.
maxSaturatedFatNUMBER
OPTIONALThe maximum number of grams of saturated fat the recipe can have.
maxVitaminENUMBER
OPTIONALThe maximum number of milligrams of Vitamin E the recipe can have.
maxIronNUMBER
OPTIONALThe maximum number of milligrams of iron the recipe can have.
maxFolateNUMBER
OPTIONALThe maximum number of micrograms of folate the recipe can have.
minCholesterolNUMBER
OPTIONALThe minimum number of milligrams of cholesterol the recipe must have.
minCarbsNUMBER
OPTIONALThe minimum number of grams of carbohydrates the recipe must have.
minSugarNUMBER
OPTIONALThe minimum number of grams of sugar the recipe must have.
maxIodineNUMBER
OPTIONALThe maximum number of micrograms of iodine the recipe can have.
maxCopperNUMBER
OPTIONALThe maximum number of milligrams of copper the recipe can have.
minFolateNUMBER
OPTIONALThe minimum number of micrograms of folate the recipe must have.
maxCaloriesNUMBER
OPTIONALThe maximum number of calories the recipe can have.
minZincNUMBER
OPTIONALThe minimum number of milligrams of zinc the recipe must have.
dietSTRING
OPTIONALThe diet to which the recipes must be compliant. Possible values are: pescetarian, lacto vegetarian, ovo vegetarian, vegan, paleo, primal, and vegetarian.
minSodiumNUMBER
OPTIONALThe minimum number of milligrams of sodium the recipe must have.
maxCalciumNUMBER
OPTIONALThe maximum number of milligrams of calcium the recipe can have.
minMagnesiumNUMBER
OPTIONALThe minimum number of milligrams of magnesium the recipe must have.
maxVitaminCNUMBER
OPTIONALThe maximum number of milligrams of Vitamin C the recipe can have.
maxZincNUMBER
OPTIONALThe maximum number of milligrams of zinc the recipe can have.
fillIngredientsBOOLEAN
OPTIONALAdd information about the used and missing ingredients in each recipe.
minVitaminKNUMBER
OPTIONALThe minimum number of micrograms of Vitamin K the recipe must have.
maxCaffeineNUMBER
OPTIONALThe maximum number of milligrams of caffeine the recipe can have.
minVitaminANUMBER
OPTIONALThe minimum number of IU of Vitamin A the recipe must have.
maxAlcoholNUMBER
OPTIONALThe maximum number of grams of alcohol the recipe can have.
minFiberNUMBER
OPTIONALThe minimum number of grams of fiber the recipe must have.
maxVitaminB5NUMBER
OPTIONALThe maximum number of milligrams of Vitamin B5 the recipe can have.
maxVitaminKNUMBER
OPTIONALThe maximum number of micrograms of Vitamin K the recipe can have.
minManganeseNUMBER
OPTIONALThe minimum number of milligrams of manganese the recipe must have.
minFluorideNUMBER
OPTIONALThe minimum number of milligrams of fluoride the recipe must have.
cuisineSTRING
OPTIONALThe cuisine(s) of the recipes. One or more (comma separated) of the following: african, chinese, japanese, korean, vietnamese, thai, indian, british, irish, french, italian, mexican, spanish, middle eastern, jewish, american, cajun, southern, greek, german, nordic, eastern european, caribbean, or latin american.
minCalciumNUMBER
OPTIONALThe minimum number of milligrams of calcium the recipe must have.
minFolicAcidNUMBER
OPTIONALThe minimum number of micrograms of folic acid the recipe must have.
minCopperNUMBER
OPTIONALThe minimum number of milligrams of copper the recipe must have.
maxCholesterolNUMBER
OPTIONALThe maximum number of milligrams of cholesterol the recipe can have.
minSaturatedFatNUMBER
OPTIONALThe minimum number of grams of saturated fat the recipe must have.
maxMagnesiumNUMBER
OPTIONALThe maximum number of milligrams of magnesium the recipe can have.
minVitaminCNUMBER
OPTIONALThe minimum number of milligrams of Vitamin C the recipe must have.
equipmentSTRING
OPTIONALThe equipment required. Multiple values will be interpreted as 'or'. For example, value could be "blender, frying pan, bowl"
maxVitaminB12NUMBER
OPTIONALThe maximum number of micrograms of Vitamin B12 the recipe can have.
offsetNUMBER
OPTIONALThe number of results to skip (between 0 and 900).
minVitaminB5NUMBER
OPTIONALThe minimum number of milligrams of Vitamin B5 the recipe must have.
maxFiberNUMBER
OPTIONALThe maximum number of grams of fiber the recipe can have.
minSeleniumNUMBER
OPTIONALThe minimum number of micrograms of selenium the recipe must have.
minVitaminB2NUMBER
OPTIONALThe minimum number of milligrams of Vitamin B2 the recipe must have.
maxSugarNUMBER
OPTIONALThe maximum number of grams of sugar the recipe can have.
minFatNUMBER
OPTIONALThe minimum number of grams of fat the recipe must have.
minVitaminB1NUMBER
OPTIONALThe minimum number of milligrams of Vitamin B1 the recipe must have.
minVitaminDNUMBER
OPTIONALThe minimum number of micrograms of Vitamin D the recipe must have.
maxManganeseNUMBER
OPTIONALThe maximum number of milligrams of manganese the recipe can have.
minPhosphorusNUMBER
OPTIONALThe minimum number of milligrams of phosphorus the recipe must have.
maxCholineNUMBER
OPTIONALThe maximum number of milligrams of choline the recipe can have.
maxFluorideNUMBER
OPTIONALThe maximum number of milligrams of fluoride the recipe can have.
includeIngredientsSTRING
OPTIONALA comma-separated list of ingredients that should/must be contained in the recipe.
minIodineNUMBER
OPTIONALThe minimum number of micrograms of iodine the recipe must have.
authorSTRING
OPTIONALThe username of the recipe author.
querySTRING
OPTIONALThe recipe search query.
instructionsRequiredBOOLEAN
OPTIONALWhether the recipes must have instructions.
maxVitaminANUMBER
OPTIONALThe maximum number of IU of Vitamin A the recipe can have.
minVitaminB3NUMBER
OPTIONALThe minimum number of milligrams of Vitamin B3 the recipe must have.
typeSTRING
OPTIONALThe type of the recipes. One of the following: main course, side dish, dessert, appetizer, salad, bread, breakfast, soup, beverage, sauce, or drink.
limitLicenseBOOLEAN
OPTIONALWhether the recipes should have an open license that allows for displaying with proper attribution.
maxSeleniumNUMBER
OPTIONALThe maximum number of micrograms of selenium the recipe can have.
maxVitaminDNUMBER
OPTIONALThe maximum number of micrograms of Vitamin D the recipe can have.
minProteinNUMBER
OPTIONALThe minimum number of grams of protein the recipe must have.
maxVitaminB3NUMBER
OPTIONALThe maximum number of milligrams of Vitamin B3 the recipe can have.
rankingNUMBER
OPTIONALWhether to minimize missing ingredients (0), maximize used ingredients (1) first, or rank recipes by relevance (2).
maxProteinNUMBER
OPTIONALThe maximum number of grams of protein the recipe can have.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication