recipe-food-nutrition

Features

• Extensive Recipe Database: Access thousands of recipes, including options for special diets such as vegan, vegetarian, pescetarian, gluten-free, and more.
• Nutritional Information: Automatically calculate nutritional information for any recipe, including macro and micronutrients.
• Recipe Search: Utilize advanced filtering and ranking options to search recipes by ingredients, nutrients, and dietary requirements.
• Ingredient Management: Convert ingredient amounts, find substitutes, and compute ingredient amounts needed for specific nutritional goals.
• Meal Planning: Generate meal plans based on dietary needs and available ingredients, and create shopping lists to simplify meal preparation.

Tools

1. search_recipes

   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, each request counts as 3 requests.

2. search_recipes_complex

   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.

3. search_recipes_by_nutrients

   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.

4. search_recipes_by_ingredients

   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.

5. get_recipe_information

   Get information about a recipe.

6. get_recipe_information_bulk

   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 counts as one request.

7. get_similar_recipes

   Find recipes which are similar to the given one.

8. get_random_recipes

   Find random (popular) recipes.

9. autocomplete_recipe_search

   Autocomplete a partial input to possible recipe names.

10. taste_by_id

    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 open scale of 0 and above. Every ingredient has each of these values and it is weighted by how much they contribute to the recipe. Spiciness is taking the weight of the spicy ingredient and multiplying it with its scoville amount. Of course, taste is also very personal and it depends on how it is prepared so all of the values should only give you an indication of how the dish tastes.

11. equipment_by_id

    Get a recipe's equipment list.

12. price_breakdown_by_id

    Get a recipe's price breakdown data.

13. ingredients_by_id

    Get a recipe's ingredient list.

14. nutrition_by_id

    Get a recipe's nutrition widget data.

15. get_analyzed_recipe_instructions

    Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and the equipment that is used.

16. extract_recipe_from_website

    Extract recipe data from a recipe blog or Web page.

17. analyze_recipe

    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 useful if you have your own recipe data and want to enrich it with our semantic analysis.

18. summarize_recipe

    Summarize the recipe in a short text.

19. analyze_recipe_instructions

    Extract ingredients and equipment from the recipe instruction steps.

20. classify_cuisine

    Classify the recipe's cuisine.

21. analyze_arecipe_search_query

    Parse a recipe search query to find out its intention.

22. guess_nutrition_by_dish_name

    Guess the macro nutrients of a dish given its title.

23. ingredient_search

    Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).

24. get_ingredient_information

    Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle.

25. compute_ingredient_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?

26. convert_amounts

    Convert amounts like "2 cups of flour to grams".

27. parse_ingredients

    Extract an ingredient from plain text.

28. compute_glycemic_load

    Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load.

29. autocomplete_ingredient_search

    Autocomplete a search for an ingredient.

30. get_ingredient_substitutes

    Get ingredient substitutes by ingredient name.

31. get_ingredient_substitutes_by_id

    Search for substitutes for a given ingredient.

32. search_grocery_products

    Search packaged food products like frozen pizza and snickers bars.

33. search_grocery_products_by_upc

    Get information about a food product given its UPC.

34. get_product_information

    Get information about a packaged food product.

35. get_comparable_products

    Find comparable products to the given one.

36. autocomplete_product_search

    Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only.

37. classify_agrocery_product

    Given a grocery product title, this endpoint allows you to detect what basic ingredient it is.

38. classify_grocery_product_bulk

    Provide a set of product jsons, get back classified products.

39. map_ingredients_to_grocery_products

    Map a set of ingredients to products you can buy in the grocery store.

40. search_menu_items

    Search menu items (such as McDonalds Big Mac)

41. get_menu_item_information

    Get information about a certain menu item.

42. autocomplete_menu_item_search

    Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only.

43. get_meal_plan_week

    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.

44. get_meal_plan_day

    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.

45. generate_meal_plan

    Generate a meal plan with three meals per day (breakfast, lunch, and dinner).

46. add_to_meal_plan

    Add an item to the user's meal plan. The Add to Meal Plan endpoint is complex, be sure to review the guide here

47. clear_meal_plan_day

    Delete all planned items from the user's meal plan for a specific day.

48. delete_from_meal_plan

    Delete an item from the user's meal plan.

49. get_meal_plan_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 here.

50. get_meal_plan_template

    Get information about a meal plan template.

51. add_meal_plan_template

    Add a meal plan template for a user.

52. delete_meal_plan_template

    Delete a meal plan template for a user.

53. get_shopping_list

    Get the current shopping list for the given user.

54. add_to_shopping_list

    Add an item to the current shopping list of a user.

55. delete_from_shopping_list

    Delete an item from the current shopping list of the user.

56. generate_shopping_list

    Generate the shopping list for a user from the meal planner in a given time frame.

57. compute_shopping_list

    Compute a shopping list from a set of simple foods. This endpoint does not require usernames.

58. search_custom_foods

    Search custom foods in a user's account.

59. connect_user

    In order to call user-specific endpoints, you need to connect your app's users to spoonacular users. Just call this endpoint with your user's information and you will get back a username and hash that you must save on your side. In future requests that you make on this user's behalf you simply pass their username and hash alongside your API key.

60. dish_pairing_for_wine

    Find a dish that goes well with a given wine.

61. wine_pairing

    Find a wine that goes well with a food. Food can be a dish name ("lasagna"), an ingredient name ("salmon"), or a cuisine ("italian").

62. wine_description

    Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot".

63. wine_recommendation

    Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot".

64. search_all_food

    Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos.

65. image_classification

    Classify a food image.

66. image_analysis

    Classify and analyze a food image.

67. search_food_videos

    Find recipe and other food related videos.

68. quick_answer

    Answer a nutrition related natural language question.

69. detect_food_in_text

    Detect ingredients and dishes in texts.

70. search_site_content

    Search spoonacular's site content. You'll be able to find everything that you could also find using the search suggests on spoonacular.com. This is a suggest API so you can send partial strings as queries.

71. get_arandom_food_joke

    Get a random joke that includes or is about food.

72. get_random_food_trivia

    Returns random food trivia.

73. talk_to_chatbot

    This endpoint can be used to have a conversation about food with the spoonacular chat bot. Use the chat suggests endpoint to show your user what he or she can say.

74. conversation_suggests

    This endpoint returns suggestions for things the user can say or ask the chat bot.

75. recipe_nutrition_label_widget

    Get a recipe's nutrition label as an HTML widget.

76. recipe_nutrition_label_image

    Get a recipe's nutrition label as an image.

77. recipe_nutrition_widget

    Visualize a recipe's nutritional information as HTML including CSS. Full example code of how to work with widgets can be found in our spoonacular-widget GitHub.

78. recipe_nutrition_by_id_widget

    Visualize a recipe's nutritional information as HTML including CSS.

79. recipe_nutrition_by_id_image

    Visualize a recipe's nutritional information as an image.

80. equipment_by_id_widget

    Visualize a recipe's equipment list.

81. equipment_widget

    Visualize the equipment used to make a recipe.

82. equipment_by_id_image

    Visualize a recipe's equipment list as an image.

83. ingredients_widget

    Visualize ingredients of a recipe.

84. ingredients_by_id_widget

    Visualize a recipe's ingredient list.

85. ingredients_by_id_image

    Visualize a recipe's ingredient list.

86. price_breakdown_widget

    Visualize the price breakdown of a recipe.

87. price_breakdown_by_id_image

    Visualize a recipe's price breakdown.

88. product_nutrition_label_widget

    Get a product's nutrition label as an HTML widget.

89. product_nutrition_label_image

    Get a product's nutrition label as an image.

90. product_nutrition_by_id_widget

    Visualize a product's nutritional information as HTML including CSS.

91. product_nutrition_by_id_image

    Visualize a product's nutritional information as an image.

92. menu_item_nutrition_label_widget

    Visualize a menu item's nutritional label information as HTML including CSS.

93. menu_item_nutrition_label_image

    Visualize a menu item's nutritional label information as an image.

94. menu_item_nutrition_by_id_widget

    Visualize a menu item's nutritional information as HTML including CSS.

95. menu_item_nutrition_by_id_image

    Visualize a menu item's nutritional information as HTML including CSS.

96. get_recipe_card

    Generate a recipe card for a recipe.

97. create_recipe_card

    Create a recipe card given a recipe.