Recipe - Food - Nutrition
By spoonacular
Updated 15 days ago

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.

Learn more about this API
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
GETExtract Recipe from Website
POSTParse Ingredients
GETAnalyze a Recipe Search Query
POSTAnalyze Recipe Instructions
POSTDetect Food in Text
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
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
GETTalk to a chatbot
GETGet Conversation Suggests
GETSearch Recipes

Search recipes in natural language.

Header Parameters
Required Parameters
REQUIREDThe (natural language) recipe search query.
Optional Parameters
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.
OPTIONALThe diet to which the recipes must be compliant. Possible values are: pescetarian, lacto vegetarian, ovo vegetarian, vegan, and vegetarian.
OPTIONALAn comma-separated list of ingredients or ingredient types that must not be contained in the recipes.
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.
OPTIONALThe number of results to return (between 0 and 100).
OPTIONALThe number of results to skip (between 0 and 900).
OPTIONALThe type of the recipes. One of the following: main course, side dish, dessert, appetizer, salad, bread, breakfast, soup, beverage, sauce, or drink.
OPTIONALWhether the recipes should have an open license that allows for displaying with proper attribution.
OPTIONALWhether the recipes must have instructions.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication