Recipe - Food - Nutrition
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…
792 subscribers
9.9/10 popularity
399 ms avg latency
95% success rate
100 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Recipe - Food - Nutrition endpoints
| Method | Endpoint | Description |
|---|---|---|
| Recipes | ||
| GET |
Search Recipes /recipes/complexSearch |
Search through thousands of recipes using advanced filtering and ranking. NOTE: Since this method combines searching by query, by ingredients, and by nutrients into one endpoint,… |
| GET |
Search Recipes (Deprecated) /recipes/search |
Search recipes in natural language. |
| GET |
Search Recipes Complex (Deprecated) /recipes/searchComplex |
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… |
| GET |
Search Recipes by Nutrients /recipes/findByNutrients |
Find a set of recipes that adhere to the given nutrient limits. All the found recipes will have macro nutrients within the calories, protein, fat, and carbohydrate limits. |
| GET |
Search Recipes by Ingredients /recipes/findByIngredients |
Find recipes that use as many of the given ingredients as possible and have as little as possible missing ingredients. This is a whats in your fridge API endpoint. |
| GET |
Get Recipe Information /recipes/{id}/information |
Get information about a recipe. |
| GET |
Get Recipe Information Bulk /recipes/informationBulk |
Get information about multiple recipes at once. That is equivalent of calling the Get Recipe Information endpoint multiple times but is faster. Note that each returned recipe… |
| GET |
Get Similar Recipes /recipes/{id}/similar |
Find recipes which are similar to the given one. |
| GET |
Get Random Recipes /recipes/random |
Find random (popular) recipes. |
| GET |
Autocomplete Recipe Search /recipes/autocomplete |
Autocomplete a partial input to possible recipe names. |
| GET |
Taste by ID /recipes/{id}/tasteWidget.json |
Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty. These tastes are between 0 and 100 while the spiciness value is in scoville on an… |
| GET |
Equipment by ID /recipes/{id}/equipmentWidget.json |
Get a recipe's equipment list. |
| GET |
Price Breakdown by ID /recipes/{id}/priceBreakdownWidget.json |
Get a recipe's price breakdown data. |
| GET |
Ingredients by ID /recipes/{id}/ingredientWidget.json |
Get a recipe's ingredient list. |
| GET |
Nutrition by ID /recipes/{id}/nutritionWidget.json |
Get a recipe's nutrition widget data. |
| GET |
Get Analyzed Recipe Instructions /recipes/{id}/analyzedInstructions |
Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and the equipment that is used. |
| GET |
Extract Recipe from Website /recipes/extract |
Extract recipe data from a recipe blog or Web page. |
| POST |
Analyze Recipe /recipes/analyze |
This endpoint allows you to send raw recipe information, such as title, servings, and ingredients, to then see what we compute (badges, diets, nutrition, and more). This is… |
| GET |
Summarize Recipe /recipes/{id}/summary |
Summarize the recipe in a short text. |
| POST |
Analyze Recipe Instructions /recipes/analyzeInstructions |
Extract ingredients and equipment from the recipe instruction steps. |
| POST |
Classify Cuisine /recipes/cuisine |
Classify the recipe's cuisine. |
| GET |
Analyze a Recipe Search Query /recipes/queries/analyze |
Parse a recipe search query to find out its intention. |
| GET |
Guess Nutrition by Dish Name /recipes/guessNutrition |
Guess the macro nutrients of a dish given its title. |
| Ingredients | ||
| GET |
Ingredient Search /food/ingredients/search |
Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.). |
| GET |
Get Ingredient Information /food/ingredients/{id}/information |
Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle. |
| GET |
Compute Ingredient Amount /food/ingredients/{id}/amount |
Compute the amount you need of a certain ingredient for a certain nutritional goal. For example, how much soy milk do you have to drink to get 10 grams of protein? |
| GET |
Convert Amounts /recipes/convert |
Convert amounts like "2 cups of flour to grams". |
| POST |
Parse Ingredients /recipes/parseIngredients |
Extract an ingredient from plain text. |
| POST |
Compute Glycemic Load /food/ingredients/glycemicLoad |
Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load. |
| GET |
Autocomplete Ingredient Search /food/ingredients/autocomplete |
Autocomplete a search for an ingredient. |
| GET |
Get Ingredient Substitutes /food/ingredients/substitutes |
Get ingredient substitutes by ingredient name. |
| GET |
Get Ingredient Substitutes by ID /food/ingredients/{id}/substitutes |
Search for substitutes for a given ingredient. |
| Products | ||
| GET |
Search Grocery Products /food/products/search |
Search packaged food products like frozen pizza and snickers bars. |
| GET |
Search Grocery Products by UPC /food/products/upc/{upc} |
Get information about a food product given its UPC. |
| GET |
Get Product Information /food/products/{id} |
Get information about a packaged food product. |
| GET |
Get Comparable Products /food/products/upc/{upc}/comparable |
Find comparable products to the given one. |
| GET |
Autocomplete Product Search /food/products/suggest |
Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only. |
| POST |
Classify a Grocery Product /food/products/classify |
Given a grocery product title, this endpoint allows you to detect what basic ingredient it is. |
| POST |
Classify Grocery Product Bulk /food/products/classifyBatch |
Provide a set of product jsons, get back classified products. |
| POST |
Map Ingredients to Grocery Products /food/ingredients/map |
Map a set of ingredients to products you can buy in the grocery store. |
| Menu Items | ||
| GET |
Search Menu Items /food/menuItems/search |
Search menu items (such as McDonalds Big Mac) |
| GET |
Get Menu Item Information /food/menuItems/{id} |
Get information about a certain menu item. |
| GET |
Autocomplete Menu Item Search /food/menuItems/suggest |
Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only. |
| Meal Planning | ||
| GET |
Get Meal Plan Week /mealplanner/{username}/week/{start-date} |
Retrieve a meal planned week for the given user. The username must be a spoonacular user and the hash must the the user's hash that can be found in his/her account. |
| GET |
Get Meal Plan Day /mealplanner/{username}/day/{date} |
Retrieve a meal planned day for the given user. The username must be a spoonacular user and the hash must the the user's hash that can be found in his/her account. |
| GET |
Generate Meal Plan /recipes/mealplans/generate |
Generate a meal plan with three meals per day (breakfast, lunch, and dinner). |
| POST |
Add to Meal Plan /mealplanner/{username}/items |
Add an item to the user's meal plan. The Add to Meal Plan endpoint is complex, be sure to review the [guide here](https://spoonacular.com/food-api/docs#Add-to-Meal-Plan) |
| DELETE |
Clear Meal Plan Day /mealplanner/{username}/day/{date} |
Delete all planned items from the user's meal plan for a specific day. |
| DELETE |
Delete from Meal Plan /mealplanner/{username}/items/{id} |
Delete an item from the user's meal plan. |
| GET |
Get Meal Plan Templates /mealplanner/{username}/templates |
Get meal plan templates from user or public ones. This documentation is for getting user templates. You can also get public templates. Read more about this… |
+ 50 more endpoints on the provider's documentation.
Recipe - Food - Nutrition pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 2 / second |
|
| PRO | $29 / month | — |
|
| ULTRA Recommended | $99 / month | — |
|
| MEGA | $999 / month | — |
|
