spoonacular API
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.
| Endpoint | Description |
|---|---|
 GET /mealplanner/{username}/templates/{id} | Get Meal Plan Template Get information about a meal plan template. |
| POST /mealplanner/{username}/templates | Add Meal Plan Template Add a meal plan template for a user. |
| DELETE /mealplanner/{username}/day/{date} | Clear Meal Plan Day Delete all planned items from the user's meal plan for a specific day. |
| DELETE /mealplanner/{username}/items/{id} | Delete from Meal Plan Delete an item from the user's meal plan. |
| DELETE /mealplanner/{username}/shopping-list/items/{id} | Delete from Shopping List Delete an item from the current shopping list of the user. |
| DELETE /mealplanner/{username}/templates/{id} | Delete Meal Plan Template Delete a meal plan template for a user. |
| GET /food/converse | Talk to Chatbot 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… |
| GET /food/converse/suggest | Conversation Suggests This endpoint returns suggestions for things the user can say or ask the chatbot. |
| GET /food/customFoods/search | Search Custom Foods Search custom foods in a user's account. |
| GET /food/images/analyze | Image Analysis by URL Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes. |
| GET /food/images/classify | Image Classification by URL Classify a food image. |
| GET /food/ingredients/{id}/amount | Compute Ingredient Amount 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? |
| GET /food/ingredients/{id}/information | Get Ingredient Information Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle. |
| GET /food/ingredients/{id}/substitutes | Get Ingredient Substitutes by ID Search for substitutes for a given ingredient. |
| GET /food/ingredients/autocomplete | Autocomplete Ingredient Search Autocomplete the entry of an ingredient. |
| GET /food/ingredients/search | Ingredient Search Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.). |
| GET /food/ingredients/substitutes | Get Ingredient Substitutes Search for substitutes for a given ingredient. |
| GET /food/jokes/random | Random Food Joke Get a random joke that is related to food. Caution: this is an endpoint for adults! |
| GET /food/menuItems/{id} | Get Menu Item Information Use a menu item id to get all available information about a menu item, such as nutrition. |
| GET /food/menuItems/{id}/nutritionLabel | Menu Item Nutrition Label Widget Visualize a menu item's nutritional label information as HTML including CSS. |
| GET /food/menuItems/{id}/nutritionLabel.png | Menu Item Nutrition Label Image Visualize a menu item's nutritional label information as an image. |
| GET /food/menuItems/{id}/nutritionWidget | Menu Item Nutrition by ID Widget Visualize a menu item's nutritional information as HTML including CSS. |
| GET /food/menuItems/{id}/nutritionWidget.png | Menu Item Nutrition by ID Image Visualize a menu item's nutritional information as HTML including CSS. |
| GET /food/menuItems/search | Search Menu Items Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha. |
| GET /food/menuItems/suggest | 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. |
| GET /food/products/{id} | Get Product Information Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving. |
| GET /food/products/{id}/nutritionLabel | Product Nutrition Label Widget Get a product's nutrition label as an HTML widget. |
| GET /food/products/{id}/nutritionLabel.png | Product Nutrition Label Image Get a product's nutrition label as an image. |
| GET /food/products/{id}/nutritionWidget | Product Nutrition by ID Widget Visualize a product's nutritional information as HTML including CSS. |
| GET /food/products/{id}/nutritionWidget.png | Product Nutrition by ID Image Visualize a product's nutritional information as an image. |
| GET /food/products/search | Search Grocery Products Search packaged food products, such as frozen pizza or Greek yogurt. |
| GET /food/products/suggest | Autocomplete Product Search Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only. |
| GET /food/products/upc/{upc} | Search Grocery Products by UPC Get information about a packaged food using its UPC. |
| GET /food/products/upc/{upc}/comparable | Get Comparable Products Find comparable products to the given one. |
| GET /food/restaurants/search | Search Restaurants Search through thousands of restaurants (in North America) by location, cuisine, budget, and more. |
| GET /food/search | Search All Food Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos. |
| GET /food/site/search | Search Site Content 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… |
| GET /food/trivia/random | Random Food Trivia Returns random food trivia. |
| GET /food/videos/search | Search Food Videos Find recipe and other food related videos. |
| GET /food/wine/description | Wine Description Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot". |
| GET /food/wine/dishes | Dish Pairing for Wine Find a dish that goes well with a given wine. |
| GET /food/wine/pairing | Wine Pairing Find a wine that goes well with a food. Food can be a dish name ("steak"), an ingredient name ("salmon"), or a cuisine ("italian"). |
| GET /food/wine/recommendation | Wine Recommendation Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot". |
| GET /mealplanner/{username}/shopping-list | Get Shopping List Get the current shopping list for the given user. |
| GET /mealplanner/{username}/templates | Get Meal Plan Templates Get meal plan templates from user or public ones. |
| GET /mealplanner/{username}/week/{start-date} | 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. |
| GET /mealplanner/generate | Generate Meal Plan Generate a meal plan with three meals per day (breakfast, lunch, and dinner). |
| GET /recipes/{id}/analyzedInstructions | Get Analyzed Recipe Instructions Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required. |
| GET /recipes/{id}/card | Create Recipe Card Generate a recipe card for a recipe. |
| GET /recipes/{id}/equipmentWidget | Equipment by ID Widget Visualize a recipe's equipment list. |
| GET /recipes/{id}/equipmentWidget.json | Equipment by ID Get a recipe's equipment list. |
| GET /recipes/{id}/equipmentWidget.png | Equipment by ID Image Visualize a recipe's equipment list as an image. |
| GET /recipes/{id}/information | Get Recipe Information Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc. |
| GET /recipes/{id}/ingredientWidget | Ingredients by ID Widget Visualize a recipe's ingredient list. |
| GET /recipes/{id}/ingredientWidget.json | Ingredients by ID Get a recipe's ingredient list. |
| GET /recipes/{id}/ingredientWidget.png | Ingredients by ID Image Visualize a recipe's ingredient list. |
| GET /recipes/{id}/nutritionLabel | Recipe Nutrition Label Widget Get a recipe's nutrition label as an HTML widget. |
| GET /recipes/{id}/nutritionLabel.png | Recipe Nutrition Label Image Get a recipe's nutrition label as an image. |
| GET /recipes/{id}/nutritionWidget | Recipe Nutrition by ID Widget Visualize a recipe's nutritional information as HTML including CSS. |
| GET /recipes/{id}/nutritionWidget.json | Nutrition by ID Get a recipe's nutrition data. |
| GET /recipes/{id}/nutritionWidget.png | Recipe Nutrition by ID Image Visualize a recipe's nutritional information as an image. |
| GET /recipes/{id}/priceBreakdownWidget | Price Breakdown by ID Widget Visualize a recipe's price breakdown. |
| GET /recipes/{id}/priceBreakdownWidget.json | Price Breakdown by ID Get a recipe's price breakdown data. |
| GET /recipes/{id}/priceBreakdownWidget.png | Price Breakdown by ID Image Visualize a recipe's price breakdown. |
| GET /recipes/{id}/similar | Get Similar Recipes Find recipes which are similar to the given one. |
| GET /recipes/{id}/summary | Summarize Recipe Automatically generate a short description that summarizes key information about the recipe. |
| GET /recipes/{id}/tasteWidget | Recipe Taste by ID Widget Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty. |
| GET /recipes/{id}/tasteWidget.json | Taste by ID Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty. |
| GET /recipes/{id}/tasteWidget.png | Recipe Taste by ID Image Get a recipe's taste as an image. The tastes supported are sweet, salty, sour, bitter, savory, and fatty. |
| GET /recipes/autocomplete | Autocomplete Recipe Search Autocomplete a partial input to suggest possible recipe names. |
| GET /recipes/complexSearch | Search Recipes 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. |
| GET /recipes/convert | Convert Amounts Convert amounts like "2 cups of flour to grams". |
| GET /recipes/extract | Extract Recipe from Website This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website. |
| GET /recipes/findByIngredients | Search Recipes by Ingredients 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… |
| GET /recipes/findByNutrients | Search Recipes by Nutrients 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… |
| GET /recipes/guessNutrition | Guess Nutrition by Dish Name Estimate the macronutrients of a dish based on its title. |
| GET /recipes/informationBulk | Get Recipe Information Bulk Get information about multiple recipes at once. This is equivalent to calling the Get Recipe Information endpoint multiple times, but faster. |
| GET /recipes/queries/analyze | Analyze a Recipe Search Query Parse a recipe search query to find out its intention. |
| GET /recipes/quickAnswer | Quick Answer Answer a nutrition related natural language question. |
| GET /recipes/random | Get Random Recipes 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… |
| POST /food/detect | Detect Food in Text 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… |
| POST /food/ingredients/glycemicLoad | Compute Glycemic Load Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load. |
| POST /food/ingredients/map | Map Ingredients to Grocery Products Map a set of ingredients to products you can buy in the grocery store. |
| POST /food/products/classify | Classify Grocery Product This endpoint allows you to match a packaged food to a basic category, e.g. a specific brand of milk to the category milk. |
| POST /food/products/classifyBatch | Classify Grocery Product Bulk Provide a set of product jsons, get back classified products. |
| POST /mealplanner/{username}/items | Add to Meal Plan Add an item to the user's meal plan. |
| POST /mealplanner/{username}/shopping-list/{start-date}/{end-date} | Generate Shopping List Generate the shopping list for a user from the meal planner in a given time frame. |
| POST /mealplanner/{username}/shopping-list/items | Add to Shopping List Add an item to the current shopping list of a user. |
| POST /recipes/analyze | 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… |
| POST /recipes/analyzeInstructions | Analyze Recipe Instructions This endpoint allows you to break down instructions into atomic steps. Furthermore, each step will contain the ingredients and equipment required. Additionally, all… |
| POST /recipes/cuisine | Classify Cuisine Classify the recipe's cuisine. |
| POST /recipes/parseIngredients | Parse Ingredients Extract an ingredient from plain text. |
| POST /recipes/visualizeEquipment | Equipment Widget Visualize the equipment used to make a recipe. |
| POST /recipes/visualizeIngredients | Ingredients Widget Visualize ingredients of a recipe. You can play around with that endpoint! |
| POST /recipes/visualizeNutrition | Recipe Nutrition Widget Visualize a recipe's nutritional information as HTML including CSS. |
| POST /recipes/visualizePriceEstimator | Price Breakdown Widget Visualize the price breakdown of a recipe. |
| POST /recipes/visualizeRecipe | Create Recipe Card Generate a recipe card for a recipe. |
| POST /recipes/visualizeTaste | Recipe Taste Widget Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint! |
| POST /users/connect | Connect User In order to call user-specific endpoints, you need to connect your app's users to spoonacular users. |
© VyDevSoft, 2026 •
updated: Feb 18, 2026
Comment or report problem with topic
Comment or report problem with topic
