spoonacular API

OpenAPI apis-guru social

The spoonacular Nutrition, Recipe, and Food API allows you to access over thousands of recipes, thousands of ingredients, 800,000 food products, over 100,000 menu items, and restaurants. 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, whole 30, low sodium, low carb, Paleo, ketogenic, FODMAP, and Primal.

Homepage: https://api.apis.guru/v2/specs/spoonacular.com/1.1.json
Provider: spoonacular.com
OpenAPI version: 3.0.0
Spec (JSON): https://api.apis.guru/v2/specs/spoonacular.com/1.1/openapi.json
Spec (YAML): https://api.apis.guru/v2/specs/spoonacular.com/1.1/openapi.yaml

Tools (101)

Extracted live via the executor SDK.

food.searchRestaurants

Search through thousands of restaurants (in North America) by location, cuisine, budget, and more.
ingredients.autocompleteIngredientSearch

Autocomplete the entry of an ingredient.
ingredients.computeIngredientAmount

Compute the amount you need of a certain ingredient for a certain nutritional goal. For example, how much pineapple do you have to eat to get 10 grams of protein?
ingredients.getIngredientInformation

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

Search for substitutes for a given ingredient.
ingredients.getIngredientSubstitutesById

Search for substitutes for a given ingredient.
ingredients.ingredientsByIdImage

Visualize a recipe's ingredient list.
ingredients.ingredientSearch

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

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

Visualize ingredients of a recipe. You can play around with that endpoint!
mealPlanning.addMealPlanTemplate

Add a meal plan template for a user.
mealPlanning.addToMealPlan

Add an item to the user's meal plan.
mealPlanning.addToShoppingList

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

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

In order to call user-specific endpoints, you need to connect your app's users to spoonacular users.
mealPlanning.deleteFromMealPlan

Delete an item from the user's meal plan.
mealPlanning.deleteFromShoppingList

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

Delete a meal plan template for a user.
mealPlanning.generateMealPlan

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

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

Get information about a meal plan template.
mealPlanning.getMealPlanTemplates

Get meal plan templates from user or public ones.
mealPlanning.getMealPlanWeek

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.
mealPlanning.getShoppingList

Get the current shopping list for the given user.
menuItems.autocompleteMenuItemSearch

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

Use a menu item id to get all available information about a menu item, such as nutrition.
menuItems.menuItemNutritionByIdImage

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

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

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

Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha.
menuItems.visualizeMenuItemNutritionById

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

Take any text and find all mentions of food contained within it. This task is also called Named Entity Recognition (NER). In this case, the entities are foods. Either dishes, such as pizza or cheeseburger, or ingredients, such as cucumber or almonds.
misc.getARandomFoodJoke

Get a random joke that is related to food. Caution: this is an endpoint for adults!
misc.getConversationSuggests

This endpoint returns suggestions for things the user can say or ask the chatbot.
misc.getRandomFoodTrivia

Returns random food trivia.
misc.imageAnalysisByUrl

Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes.
misc.imageClassificationByUrl

Classify a food image.
misc.searchAllFood

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

Search custom foods in a user's account.
misc.searchFoodVideos

Find recipe and other food related videos.
misc.searchSiteContent

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

This endpoint can be used to have a conversation about food with the spoonacular chatbot. Use the "Get Conversation Suggests" endpoint to show your user what he or she can say.
products.autocompleteProductSearch

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

This endpoint allows you to match a packaged food to a basic category, e.g. a specific brand of milk to the category milk.
products.classifyGroceryProductBulk

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

Find comparable products to the given one.
products.getProductInformation

Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving.
products.productNutritionByIdImage

Visualize a product's nutritional information as an image.
products.productNutritionLabelImage

Get a product's nutrition label as an image.
products.productNutritionLabelWidget

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

Search packaged food products, such as frozen pizza or Greek yogurt.
products.searchGroceryProductsByUpc

Get information about a packaged food using its UPC.
products.visualizeProductNutritionById

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

Parse a recipe search query to find out its intention.
recipes.analyzeRecipe

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.
recipes.analyzeRecipeInstructions

This endpoint allows you to break down instructions into atomic steps. Furthermore, each step will contain the ingredients and equipment required. Additionally, all ingredients and equipment from the recipe's instructions will be extracted independently of the step they're used in.
recipes.autocompleteRecipeSearch

Autocomplete a partial input to suggest possible recipe names.
recipes.classifyCuisine

Classify the recipe's cuisine.
recipes.computeGlycemicLoad

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

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

Generate a recipe card for a recipe.
recipes.createRecipeCardGet

Generate a recipe card for a recipe.
recipes.equipmentByIdImage

Visualize a recipe's equipment list as an image.
recipes.extractRecipeFromWebsite

This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website.
recipes.getAnalyzedRecipeInstructions

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

Find random (popular) recipes. If you need to filter recipes by diet, nutrition etc. you might want to consider using the complex recipe search endpoint and set the sort request parameter to random.
recipes.getRecipeEquipmentById

Get a recipe's equipment list.
recipes.getRecipeInformation

Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc.
recipes.getRecipeInformationBulk

Get information about multiple recipes at once. This is equivalent to calling the Get Recipe Information endpoint multiple times, but faster.
recipes.getRecipeIngredientsById

Get a recipe's ingredient list.
recipes.getRecipeNutritionWidgetById

Get a recipe's nutrition data.
recipes.getRecipePriceBreakdownById

Get a recipe's price breakdown data.
recipes.getRecipeTasteById

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.
recipes.getSimilarRecipes

Find recipes which are similar to the given one.
recipes.guessNutritionByDishName

Estimate the macronutrients of a dish based on its title.
recipes.parseIngredients

Extract an ingredient from plain text.
recipes.priceBreakdownByIdImage

Visualize a recipe's price breakdown.
recipes.quickAnswer

Answer a nutrition related natural language question.
recipes.recipeNutritionByIdImage

Visualize a recipe's nutritional information as an image.
recipes.recipeNutritionLabelImage

Get a recipe's nutrition label as an image.
recipes.recipeNutritionLabelWidget

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

Get a recipe's taste as an image. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.
recipes.searchRecipes

Search through hundreds of thousands of recipes using advanced filtering and ranking. NOTE: This method combines searching by query, by ingredients, and by nutrients into one endpoint.
recipes.searchRecipesByIngredients

Ever wondered what recipes you can cook with the ingredients you have in your fridge or pantry? This endpoint lets you find recipes that either maximize the usage of ingredients you have at hand (pre shopping) or minimize the ingredients that you don't currently have (post shopping).
recipes.searchRecipesByNutrients

Find a set of recipes that adhere to the given nutritional limits. You may set limits for macronutrients (calories, protein, fat, and carbohydrate) and/or many micronutrients.
recipes.summarizeRecipe

Automatically generate a short description that summarizes key information about the recipe.
recipes.visualizeEquipment

Visualize the equipment used to make a recipe.
recipes.visualizePriceBreakdown

Visualize the price breakdown of a recipe.
recipes.visualizeRecipeEquipmentById

Visualize a recipe's equipment list.
recipes.visualizeRecipeIngredientsById

Visualize a recipe's ingredient list.
recipes.visualizeRecipeNutrition

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

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

Visualize a recipe's price breakdown.
recipes.visualizeRecipeTaste

Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint!
recipes.visualizeRecipeTasteById

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.
wine.getDishPairingForWine

Find a dish that goes well with a given wine.
wine.getWineDescription

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

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

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

Preview an OpenAPI document before adding it as a source
openapi.addSource

Add an OpenAPI source and register its operations as tools