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.
Try it
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.
Try it
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.
Try it
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.
Try it
get_recipe_information
Get information about a recipe.
Try it
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.
Try it
get_similar_recipes
Find recipes which are similar to the given one.
Try it
get_random_recipes
Find random (popular) recipes.
Try it
autocomplete_recipe_search
Autocomplete a partial input to possible recipe names.
Try it
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.
Try it
equipment_by_id
Get a recipe's equipment list.
Try it
price_breakdown_by_id
Get a recipe's price breakdown data.
Try it
ingredients_by_id
Get a recipe's ingredient list.
Try it
nutrition_by_id
Get a recipe's nutrition widget data.
Try it
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.
Try it
extract_recipe_from_website
Extract recipe data from a recipe blog or Web page.
Try it
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.
Try it
summarize_recipe
Summarize the recipe in a short text.
Try it
analyze_recipe_instructions
Extract ingredients and equipment from the recipe instruction steps.
Try it
classify_cuisine
Classify the recipe's cuisine.
Try it
analyze_arecipe_search_query
Parse a recipe search query to find out its intention.
Try it
guess_nutrition_by_dish_name
Guess the macro nutrients of a dish given its title.
Try it
ingredient_search
Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).
Try it
get_ingredient_information
Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle.
Try it
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?
Try it
convert_amounts
Convert amounts like "2 cups of flour to grams".
Try it
parse_ingredients
Extract an ingredient from plain text.
Try it
compute_glycemic_load
Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load.
Try it
autocomplete_ingredient_search
Autocomplete a search for an ingredient.
Try it
get_ingredient_substitutes
Get ingredient substitutes by ingredient name.
Try it
get_ingredient_substitutes_by_id
Search for substitutes for a given ingredient.
Try it
search_grocery_products
Search packaged food products like frozen pizza and snickers bars.
Try it
search_grocery_products_by_upc
Get information about a food product given its UPC.
Try it
get_product_information
Get information about a packaged food product.
Try it
get_comparable_products
Find comparable products to the given one.
Try it
autocomplete_product_search
Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only.
Try it
classify_agrocery_product
Given a grocery product title, this endpoint allows you to detect what basic ingredient it is.
Try it
classify_grocery_product_bulk
Provide a set of product jsons, get back classified products.
Try it
map_ingredients_to_grocery_products
Map a set of ingredients to products you can buy in the grocery store.
Try it
search_menu_items
Search menu items (such as McDonalds Big Mac)
Try it
get_menu_item_information
Get information about a certain menu item.
Try it
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.
Try it
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.
Try it
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.
Try it
generate_meal_plan
Generate a meal plan with three meals per day (breakfast, lunch, and dinner).
Try it
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](https://spoonacular.com/food-api/docs#Add-to-Meal-Plan)
Try it
clear_meal_plan_day
Delete all planned items from the user's meal plan for a specific day.
Try it
delete_from_meal_plan
Delete an item from the user's meal plan.
Try it
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](https://spoonacular.com/food-api/docs#Get-Meal-Plan-Templates).
Try it
get_meal_plan_template
Get information about a meal plan template.
Try it
add_meal_plan_template
Add a meal plan template for a user.
Try it
delete_meal_plan_template
Delete a meal plan template for a user.
Try it
get_shopping_list
Get the current shopping list for the given user.
Try it
add_to_shopping_list
Add an item to the current shopping list of a user.
Try it
delete_from_shopping_list
Delete an item from the current shopping list of the user.
Try it
generate_shopping_list
Generate the shopping list for a user from the meal planner in a given time frame.
Try it
compute_shopping_list
Compute a shopping list from a set of simple foods. This endpoint does not require usernames.
Try it
search_custom_foods
Search custom foods in a user's account.
Try it
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.
Try it
dish_pairing_for_wine
Find a dish that goes well with a given wine.
Try it
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").
Try it
wine_description
Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot".
Try it
wine_recommendation
Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot".
Try it
search_all_food
Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos.
Try it
image_classification
Classify a food image.
Try it
image_analysis
Classify and analyze a food image.
Try it
search_food_videos
Find recipe and other food related videos.
Try it
quick_answer
Answer a nutrition related natural language question.
Try it
detect_food_in_text
Detect ingredients and dishes in texts.
Try it
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.
Try it
get_arandom_food_joke
Get a random joke that includes or is about food.
Try it
get_random_food_trivia
Returns random food trivia.
Try it
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.
Try it
conversation_suggests
This endpoint returns suggestions for things the user can say or ask the chat bot.
Try it
recipe_nutrition_label_widget
Get a recipe's nutrition label as an HTML widget.
Try it
recipe_nutrition_label_image
Get a recipe's nutrition label as an image.
Try it
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](https://github.com/ddsky/spoonacular-widgets).
Try it
recipe_nutrition_by_id_widget
Visualize a recipe's nutritional information as HTML including CSS.
Try it
recipe_nutrition_by_id_image
Visualize a recipe's nutritional information as an image.
Try it
equipment_by_id_widget
Visualize a recipe's equipment list.
Try it
equipment_widget
Visualize the equipment used to make a recipe.
Try it
equipment_by_id_image
Visualize a recipe's equipment list as an image.
Try it
ingredients_widget
Visualize ingredients of a recipe.
Try it
ingredients_by_id_widget
Visualize a recipe's ingredient list.
Try it
ingredients_by_id_image
Visualize a recipe's ingredient list.
Try it
price_breakdown_widget
Visualize the price breakdown of a recipe.
Try it
price_breakdown_by_id_image
Visualize a recipe's price breakdown.
Try it
product_nutrition_label_widget
Get a product's nutrition label as an HTML widget.
Try it
product_nutrition_label_image
Get a product's nutrition label as an image.
Try it
product_nutrition_by_id_widget
Visualize a product's nutritional information as HTML including CSS.
Try it
product_nutrition_by_id_image
Visualize a product's nutritional information as an image.
Try it
menu_item_nutrition_label_widget
Visualize a menu item's nutritional label information as HTML including CSS.
Try it
menu_item_nutrition_label_image
Visualize a menu item's nutritional label information as an image.
Try it
menu_item_nutrition_by_id_widget
Visualize a menu item's nutritional information as HTML including CSS.
Try it
menu_item_nutrition_by_id_image
Visualize a menu item's nutritional information as HTML including CSS.
Try it
get_recipe_card
Generate a recipe card for a recipe.
Try it
create_recipe_card
Create a recipe card given a recipe.
Try it
