{ "opencollection": "1.0.0", "info": { "name": "spoonacular API", "version": "2.0.2" }, "request": { "auth": { "type": "apikey", "key": "x-api-key", "value": "{{x-api-key}}", "placement": "header" } }, "items": [ { "info": { "name": "Recipes", "type": "folder" }, "items": [ { "info": { "name": "Search Recipes", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/complexSearch", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "cuisine", "value": "italian", "type": "query", "description": "The cuisine(s) of the recipes. One or more, comma separated (will be interpreted as 'OR'). See a full list of supported cuisines." }, { "name": "excludeCuisine", "value": "greek", "type": "query", "description": "The cuisine(s) the recipes must not match. One or more, comma separated (will be interpreted as 'AND'). See a full list of supported cuisines." }, { "name": "diet", "value": "vegetarian", "type": "query", "description": "The diet for which the recipes must be suitable. See a full list of supported diets." }, { "name": "intolerances", "value": "gluten", "type": "query", "description": "A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the intolerances entered. See a full list of supported intolerances." }, { "name": "equipment", "value": "pan", "type": "query", "description": "The equipment required. Multiple values will be interpreted as 'or'. For example, value could be \"blender, frying pan, bowl\"." }, { "name": "includeIngredients", "value": "tomato,cheese", "type": "query", "description": "A comma-separated list of ingredients that should/must be used in the recipes." }, { "name": "excludeIngredients", "value": "eggs", "type": "query", "description": "A comma-separated list of ingredients or ingredient types that the recipes must not contain." }, { "name": "type", "value": "main course", "type": "query", "description": "The type of recipe. See a full list of supported meal types." }, { "name": "instructionsRequired", "value": "true", "type": "query", "description": "Whether the recipes must have instructions." }, { "name": "fillIngredients", "value": "false", "type": "query", "description": "Add information about the ingredients and whether they are used or missing in relation to the query." }, { "name": "addRecipeInformation", "value": "false", "type": "query", "description": "If set to true, you get more information about the recipes returned." }, { "name": "addRecipeNutrition", "value": "false", "type": "query", "description": "If set to true, you get nutritional information about each recipes returned." }, { "name": "author", "value": "coffeebean", "type": "query", "description": "The username of the recipe author." }, { "name": "tags", "value": "", "type": "query", "description": "The tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have." }, { "name": "recipeBoxId", "value": "2468", "type": "query", "description": "The id of the recipe box to which the search should be limited to." }, { "name": "titleMatch", "value": "Crock Pot", "type": "query", "description": "Enter text that must be found in the title of the recipes." }, { "name": "maxReadyTime", "value": "20", "type": "query", "description": "The maximum time in minutes it should take to prepare and cook the recipe." }, { "name": "minServings", "value": "1", "type": "query", "description": "The minimum amount of servings the recipe is for." }, { "name": "maxServings", "value": "8", "type": "query", "description": "The maximum amount of servings the recipe is for." }, { "name": "ignorePantry", "value": "", "type": "query", "description": "Whether to ignore typical pantry items, such as water, salt, flour, etc." }, { "name": "sort", "value": "calories", "type": "query", "description": "The strategy to sort recipes by. See a full list of supported sorting options." }, { "name": "sortDirection", "value": "asc", "type": "query", "description": "The direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending)." }, { "name": "minCarbs", "value": "10", "type": "query", "description": "The minimum amount of carbohydrates in grams the recipe must have." }, { "name": "maxCarbs", "value": "100", "type": "query", "description": "The maximum amount of carbohydrates in grams the recipe can have." }, { "name": "minProtein", "value": "10", "type": "query", "description": "The minimum amount of protein in grams the recipe must have." }, { "name": "maxProtein", "value": "100", "type": "query", "description": "The maximum amount of protein in grams the recipe can have." }, { "name": "minCalories", "value": "50", "type": "query", "description": "The minimum amount of calories the recipe must have." }, { "name": "maxCalories", "value": "800", "type": "query", "description": "The maximum amount of calories the recipe can have." }, { "name": "minFat", "value": "1", "type": "query", "description": "The minimum amount of fat in grams the recipe must have." }, { "name": "maxFat", "value": "100", "type": "query", "description": "The maximum amount of fat in grams the recipe can have." }, { "name": "minAlcohol", "value": "0", "type": "query", "description": "The minimum amount of alcohol in grams the recipe must have." }, { "name": "maxAlcohol", "value": "100", "type": "query", "description": "The maximum amount of alcohol in grams the recipe can have." }, { "name": "minCaffeine", "value": "0", "type": "query", "description": "The minimum amount of caffeine in milligrams the recipe must have." }, { "name": "maxCaffeine", "value": "100", "type": "query", "description": "The maximum amount of caffeine in milligrams the recipe can have." }, { "name": "minCopper", "value": "0", "type": "query", "description": "The minimum amount of copper in milligrams the recipe must have." }, { "name": "maxCopper", "value": "100", "type": "query", "description": "The maximum amount of copper in milligrams the recipe can have." }, { "name": "minCalcium", "value": "0", "type": "query", "description": "The minimum amount of calcium in milligrams the recipe must have." }, { "name": "maxCalcium", "value": "100", "type": "query", "description": "The maximum amount of calcium in milligrams the recipe can have." }, { "name": "minCholine", "value": "0", "type": "query", "description": "The minimum amount of choline in milligrams the recipe must have." }, { "name": "maxCholine", "value": "100", "type": "query", "description": "The maximum amount of choline in milligrams the recipe can have." }, { "name": "minCholesterol", "value": "0", "type": "query", "description": "The minimum amount of cholesterol in milligrams the recipe must have." }, { "name": "maxCholesterol", "value": "100", "type": "query", "description": "The maximum amount of cholesterol in milligrams the recipe can have." }, { "name": "minFluoride", "value": "0", "type": "query", "description": "The minimum amount of fluoride in milligrams the recipe must have." }, { "name": "maxFluoride", "value": "100", "type": "query", "description": "The maximum amount of fluoride in milligrams the recipe can have." }, { "name": "minSaturatedFat", "value": "0", "type": "query", "description": "The minimum amount of saturated fat in grams the recipe must have." }, { "name": "maxSaturatedFat", "value": "100", "type": "query", "description": "The maximum amount of saturated fat in grams the recipe can have." }, { "name": "minVitaminA", "value": "0", "type": "query", "description": "The minimum amount of Vitamin A in IU the recipe must have." }, { "name": "maxVitaminA", "value": "100", "type": "query", "description": "The maximum amount of Vitamin A in IU the recipe can have." }, { "name": "minVitaminC", "value": "0", "type": "query", "description": "The minimum amount of Vitamin C milligrams the recipe must have." }, { "name": "maxVitaminC", "value": "100", "type": "query", "description": "The maximum amount of Vitamin C in milligrams the recipe can have." }, { "name": "minVitaminD", "value": "0", "type": "query", "description": "The minimum amount of Vitamin D in micrograms the recipe must have." }, { "name": "maxVitaminD", "value": "100", "type": "query", "description": "The maximum amount of Vitamin D in micrograms the recipe can have." }, { "name": "minVitaminE", "value": "0", "type": "query", "description": "The minimum amount of Vitamin E in milligrams the recipe must have." }, { "name": "maxVitaminE", "value": "100", "type": "query", "description": "The maximum amount of Vitamin E in milligrams the recipe can have." }, { "name": "minVitaminK", "value": "0", "type": "query", "description": "The minimum amount of Vitamin K in micrograms the recipe must have." }, { "name": "maxVitaminK", "value": "100", "type": "query", "description": "The maximum amount of Vitamin K in micrograms the recipe can have." }, { "name": "minVitaminB1", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B1 in milligrams the recipe must have." }, { "name": "maxVitaminB1", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B1 in milligrams the recipe can have." }, { "name": "minVitaminB2", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B2 in milligrams the recipe must have." }, { "name": "maxVitaminB2", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B2 in milligrams the recipe can have." }, { "name": "minVitaminB5", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B5 in milligrams the recipe must have." }, { "name": "maxVitaminB5", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B5 in milligrams the recipe can have." }, { "name": "minVitaminB3", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B3 in milligrams the recipe must have." }, { "name": "maxVitaminB3", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B3 in milligrams the recipe can have." }, { "name": "minVitaminB6", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B6 in milligrams the recipe must have." }, { "name": "maxVitaminB6", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B6 in milligrams the recipe can have." }, { "name": "minVitaminB12", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B12 in micrograms the recipe must have." }, { "name": "maxVitaminB12", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B12 in micrograms the recipe can have." }, { "name": "minFiber", "value": "0", "type": "query", "description": "The minimum amount of fiber in grams the recipe must have." }, { "name": "maxFiber", "value": "100", "type": "query", "description": "The maximum amount of fiber in grams the recipe can have." }, { "name": "minFolate", "value": "0", "type": "query", "description": "The minimum amount of folate in micrograms the recipe must have." }, { "name": "maxFolate", "value": "100", "type": "query", "description": "The maximum amount of folate in micrograms the recipe can have." }, { "name": "minFolicAcid", "value": "0", "type": "query", "description": "The minimum amount of folic acid in micrograms the recipe must have." }, { "name": "maxFolicAcid", "value": "100", "type": "query", "description": "The maximum amount of folic acid in micrograms the recipe can have." }, { "name": "minIodine", "value": "0", "type": "query", "description": "The minimum amount of iodine in micrograms the recipe must have." }, { "name": "maxIodine", "value": "100", "type": "query", "description": "The maximum amount of iodine in micrograms the recipe can have." }, { "name": "minIron", "value": "0", "type": "query", "description": "The minimum amount of iron in milligrams the recipe must have." }, { "name": "maxIron", "value": "100", "type": "query", "description": "The maximum amount of iron in milligrams the recipe can have." }, { "name": "minMagnesium", "value": "0", "type": "query", "description": "The minimum amount of magnesium in milligrams the recipe must have." }, { "name": "maxMagnesium", "value": "100", "type": "query", "description": "The maximum amount of magnesium in milligrams the recipe can have." }, { "name": "minManganese", "value": "0", "type": "query", "description": "The minimum amount of manganese in milligrams the recipe must have." }, { "name": "maxManganese", "value": "100", "type": "query", "description": "The maximum amount of manganese in milligrams the recipe can have." }, { "name": "minPhosphorus", "value": "0", "type": "query", "description": "The minimum amount of phosphorus in milligrams the recipe must have." }, { "name": "maxPhosphorus", "value": "100", "type": "query", "description": "The maximum amount of phosphorus in milligrams the recipe can have." }, { "name": "minPotassium", "value": "0", "type": "query", "description": "The minimum amount of potassium in milligrams the recipe must have." }, { "name": "maxPotassium", "value": "100", "type": "query", "description": "The maximum amount of potassium in milligrams the recipe can have." }, { "name": "minSelenium", "value": "0", "type": "query", "description": "The minimum amount of selenium in micrograms the recipe must have." }, { "name": "maxSelenium", "value": "100", "type": "query", "description": "The maximum amount of selenium in micrograms the recipe can have." }, { "name": "minSodium", "value": "0", "type": "query", "description": "The minimum amount of sodium in milligrams the recipe must have." }, { "name": "maxSodium", "value": "100", "type": "query", "description": "The maximum amount of sodium in milligrams the recipe can have." }, { "name": "minSugar", "value": "0", "type": "query", "description": "The minimum amount of sugar in grams the recipe must have." }, { "name": "maxSugar", "value": "100", "type": "query", "description": "The maximum amount of sugar in grams the recipe can have." }, { "name": "minZinc", "value": "0", "type": "query", "description": "The minimum amount of zinc in milligrams the recipe must have." }, { "name": "maxZinc", "value": "100", "type": "query", "description": "The maximum amount of zinc in milligrams the recipe can have." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "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." }, { "info": { "name": "Search Recipes by Ingredients", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/findByIngredients", "params": [ { "name": "ingredients", "value": "", "type": "query", "description": "A comma-separated list of ingredients that the recipes should contain." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." }, { "name": "ranking", "value": "1", "type": "query", "description": "Whether to maximize used ingredients (1) or minimize missing ingredients (2) first." }, { "name": "ignorePantry", "value": "", "type": "query", "description": "Whether to ignore typical pantry items, such as water, salt, flour, etc." } ] }, "docs": "\nEver 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).\n " }, { "info": { "name": "Search Recipes by Nutrients", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/findByNutrients", "params": [ { "name": "minCarbs", "value": "10", "type": "query", "description": "The minimum amount of carbohydrates in grams the recipe must have." }, { "name": "maxCarbs", "value": "100", "type": "query", "description": "The maximum amount of carbohydrates in grams the recipe can have." }, { "name": "minProtein", "value": "10", "type": "query", "description": "The minimum amount of protein in grams the recipe must have." }, { "name": "maxProtein", "value": "100", "type": "query", "description": "The maximum amount of protein in grams the recipe can have." }, { "name": "minCalories", "value": "50", "type": "query", "description": "The minimum amount of calories the recipe must have." }, { "name": "maxCalories", "value": "800", "type": "query", "description": "The maximum amount of calories the recipe can have." }, { "name": "minFat", "value": "1", "type": "query", "description": "The minimum amount of fat in grams the recipe must have." }, { "name": "maxFat", "value": "100", "type": "query", "description": "The maximum amount of fat in grams the recipe can have." }, { "name": "minAlcohol", "value": "0", "type": "query", "description": "The minimum amount of alcohol in grams the recipe must have." }, { "name": "maxAlcohol", "value": "100", "type": "query", "description": "The maximum amount of alcohol in grams the recipe can have." }, { "name": "minCaffeine", "value": "0", "type": "query", "description": "The minimum amount of caffeine in milligrams the recipe must have." }, { "name": "maxCaffeine", "value": "100", "type": "query", "description": "The maximum amount of caffeine in milligrams the recipe can have." }, { "name": "minCopper", "value": "0", "type": "query", "description": "The minimum amount of copper in milligrams the recipe must have." }, { "name": "maxCopper", "value": "100", "type": "query", "description": "The maximum amount of copper in milligrams the recipe can have." }, { "name": "minCalcium", "value": "0", "type": "query", "description": "The minimum amount of calcium in milligrams the recipe must have." }, { "name": "maxCalcium", "value": "100", "type": "query", "description": "The maximum amount of calcium in milligrams the recipe can have." }, { "name": "minCholine", "value": "0", "type": "query", "description": "The minimum amount of choline in milligrams the recipe must have." }, { "name": "maxCholine", "value": "100", "type": "query", "description": "The maximum amount of choline in milligrams the recipe can have." }, { "name": "minCholesterol", "value": "0", "type": "query", "description": "The minimum amount of cholesterol in milligrams the recipe must have." }, { "name": "maxCholesterol", "value": "100", "type": "query", "description": "The maximum amount of cholesterol in milligrams the recipe can have." }, { "name": "minFluoride", "value": "0", "type": "query", "description": "The minimum amount of fluoride in milligrams the recipe must have." }, { "name": "maxFluoride", "value": "100", "type": "query", "description": "The maximum amount of fluoride in milligrams the recipe can have." }, { "name": "minSaturatedFat", "value": "0", "type": "query", "description": "The minimum amount of saturated fat in grams the recipe must have." }, { "name": "maxSaturatedFat", "value": "100", "type": "query", "description": "The maximum amount of saturated fat in grams the recipe can have." }, { "name": "minVitaminA", "value": "0", "type": "query", "description": "The minimum amount of Vitamin A in IU the recipe must have." }, { "name": "maxVitaminA", "value": "100", "type": "query", "description": "The maximum amount of Vitamin A in IU the recipe can have." }, { "name": "minVitaminC", "value": "0", "type": "query", "description": "The minimum amount of Vitamin C in milligrams the recipe must have." }, { "name": "maxVitaminC", "value": "100", "type": "query", "description": "The maximum amount of Vitamin C in milligrams the recipe can have." }, { "name": "minVitaminD", "value": "0", "type": "query", "description": "The minimum amount of Vitamin D in micrograms the recipe must have." }, { "name": "maxVitaminD", "value": "100", "type": "query", "description": "The maximum amount of Vitamin D in micrograms the recipe can have." }, { "name": "minVitaminE", "value": "0", "type": "query", "description": "The minimum amount of Vitamin E in milligrams the recipe must have." }, { "name": "maxVitaminE", "value": "100", "type": "query", "description": "The maximum amount of Vitamin E in milligrams the recipe can have." }, { "name": "minVitaminK", "value": "0", "type": "query", "description": "The minimum amount of Vitamin K in micrograms the recipe must have." }, { "name": "maxVitaminK", "value": "100", "type": "query", "description": "The maximum amount of Vitamin K in micrograms the recipe can have." }, { "name": "minVitaminB1", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B1 in milligrams the recipe must have." }, { "name": "maxVitaminB1", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B1 in milligrams the recipe can have." }, { "name": "minVitaminB2", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B2 in milligrams the recipe must have." }, { "name": "maxVitaminB2", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B2 in milligrams the recipe can have." }, { "name": "minVitaminB5", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B5 in milligrams the recipe must have." }, { "name": "maxVitaminB5", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B5 in milligrams the recipe can have." }, { "name": "minVitaminB3", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B3 in milligrams the recipe must have." }, { "name": "maxVitaminB3", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B3 in milligrams the recipe can have." }, { "name": "minVitaminB6", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B6 in milligrams the recipe must have." }, { "name": "maxVitaminB6", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B6 in milligrams the recipe can have." }, { "name": "minVitaminB12", "value": "0", "type": "query", "description": "The minimum amount of Vitamin B12 in micrograms the recipe must have." }, { "name": "maxVitaminB12", "value": "100", "type": "query", "description": "The maximum amount of Vitamin B12 in micrograms the recipe can have." }, { "name": "minFiber", "value": "0", "type": "query", "description": "The minimum amount of fiber in grams the recipe must have." }, { "name": "maxFiber", "value": "100", "type": "query", "description": "The maximum amount of fiber in grams the recipe can have." }, { "name": "minFolate", "value": "0", "type": "query", "description": "The minimum amount of folate in micrograms the recipe must have." }, { "name": "maxFolate", "value": "100", "type": "query", "description": "The maximum amount of folate in micrograms the recipe can have." }, { "name": "minFolicAcid", "value": "0", "type": "query", "description": "The minimum amount of folic acid in micrograms the recipe must have." }, { "name": "maxFolicAcid", "value": "100", "type": "query", "description": "The maximum amount of folic acid in micrograms the recipe can have." }, { "name": "minIodine", "value": "0", "type": "query", "description": "The minimum amount of iodine in micrograms the recipe must have." }, { "name": "maxIodine", "value": "100", "type": "query", "description": "The maximum amount of iodine in micrograms the recipe can have." }, { "name": "minIron", "value": "0", "type": "query", "description": "The minimum amount of iron in milligrams the recipe must have." }, { "name": "maxIron", "value": "100", "type": "query", "description": "The maximum amount of iron in milligrams the recipe can have." }, { "name": "minMagnesium", "value": "0", "type": "query", "description": "The minimum amount of magnesium in milligrams the recipe must have." }, { "name": "maxMagnesium", "value": "100", "type": "query", "description": "The maximum amount of magnesium in milligrams the recipe can have." }, { "name": "minManganese", "value": "0", "type": "query", "description": "The minimum amount of manganese in milligrams the recipe must have." }, { "name": "maxManganese", "value": "100", "type": "query", "description": "The maximum amount of manganese in milligrams the recipe can have." }, { "name": "minPhosphorus", "value": "0", "type": "query", "description": "The minimum amount of phosphorus in milligrams the recipe must have." }, { "name": "maxPhosphorus", "value": "100", "type": "query", "description": "The maximum amount of phosphorus in milligrams the recipe can have." }, { "name": "minPotassium", "value": "0", "type": "query", "description": "The minimum amount of potassium in milligrams the recipe must have." }, { "name": "maxPotassium", "value": "100", "type": "query", "description": "The maximum amount of potassium in milligrams the recipe can have." }, { "name": "minSelenium", "value": "0", "type": "query", "description": "The minimum amount of selenium in micrograms the recipe must have." }, { "name": "maxSelenium", "value": "100", "type": "query", "description": "The maximum amount of selenium in micrograms the recipe can have." }, { "name": "minSodium", "value": "0", "type": "query", "description": "The minimum amount of sodium in milligrams the recipe must have." }, { "name": "maxSodium", "value": "100", "type": "query", "description": "The maximum amount of sodium in milligrams the recipe can have." }, { "name": "minSugar", "value": "0", "type": "query", "description": "The minimum amount of sugar in grams the recipe must have." }, { "name": "maxSugar", "value": "100", "type": "query", "description": "The maximum amount of sugar in grams the recipe can have." }, { "name": "minZinc", "value": "0", "type": "query", "description": "The minimum amount of zinc in milligrams the recipe must have." }, { "name": "maxZinc", "value": "100", "type": "query", "description": "The maximum amount of zinc in milligrams the recipe can have." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." }, { "name": "random", "value": "false", "type": "query", "description": "If true, every request will give you a random set of recipes within the requested limits." } ] }, "docs": "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." }, { "info": { "name": "Get Recipe Information", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/information", "params": [ { "name": "id", "value": "716429", "type": "path", "description": "The id of the recipe." }, { "name": "includeNutrition", "value": "", "type": "query", "description": "Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe, just multiply by the number of servings." }, { "name": "addWinePairing", "value": "false", "type": "query", "description": "Add a wine pairing to the recipe." }, { "name": "addTasteData", "value": "false", "type": "query", "description": "Add taste data to the recipe." } ] }, "docs": "Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc." }, { "info": { "name": "Get Recipe Information Bulk", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/informationBulk", "params": [ { "name": "ids", "value": "715538,716429", "type": "query", "description": "A comma-separated list of recipe ids." }, { "name": "includeNutrition", "value": "", "type": "query", "description": "Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe, just multiply by the number of servings." } ] }, "docs": "Get information about multiple recipes at once. This is equivalent to calling the Get Recipe Information endpoint multiple times, but faster." }, { "info": { "name": "Get Similar Recipes", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/similar", "params": [ { "name": "id", "value": "715538", "type": "path", "description": "The id of the source recipe for which similar recipes should be found." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Find recipes which are similar to the given one." }, { "info": { "name": "Get Random Recipes", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/random", "params": [ { "name": "includeNutrition", "value": "", "type": "query", "description": "Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe, just multiply by the number of servings." }, { "name": "include-tags", "value": "vegetarian,gluten", "type": "query", "description": "A comma-separated list of tags that the random recipe(s) must adhere to." }, { "name": "exclude-tags", "value": "meat,dairy", "type": "query", "description": "A comma-separated list of tags that the random recipe(s) must not adhere to." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "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." }, { "info": { "name": "Autocomplete Recipe Search", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/autocomplete", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Autocomplete a partial input to suggest possible recipe names." }, { "info": { "name": "Taste by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/tasteWidget.json", "params": [ { "name": "id", "value": "69095", "type": "path", "description": "The recipe id." }, { "name": "normalize", "value": "true", "type": "query", "description": "Normalize to the strongest taste." } ] }, "docs": "Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty." }, { "info": { "name": "Recipe Taste by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/tasteWidget.png", "params": [ { "name": "id", "value": "69095", "type": "path", "description": "The recipe id." }, { "name": "normalize", "value": "false", "type": "query", "description": "Normalize to the strongest taste." }, { "name": "rgb", "value": "", "type": "query", "description": "Red, green, blue values for the chart color." } ] }, "docs": "Get a recipe's taste as an image. The tastes supported are sweet, salty, sour, bitter, savory, and fatty." }, { "info": { "name": "Equipment by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/equipmentWidget.json", "params": [ { "name": "id", "value": "1003464", "type": "path", "description": "The recipe id." } ] }, "docs": "Get a recipe's equipment list." }, { "info": { "name": "Equipment by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/equipmentWidget.png", "params": [ { "name": "id", "value": "44860", "type": "path", "description": "The recipe id." } ] }, "docs": "Visualize a recipe's equipment list as an image." }, { "info": { "name": "Price Breakdown by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/priceBreakdownWidget.json", "params": [ { "name": "id", "value": "1003464", "type": "path", "description": "The recipe id." } ] }, "docs": "Get a recipe's price breakdown data." }, { "info": { "name": "Price Breakdown by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/priceBreakdownWidget.png", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." } ] }, "docs": "Visualize a recipe's price breakdown." }, { "info": { "name": "Ingredients by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/ingredientWidget.json", "params": [ { "name": "id", "value": "1003464", "type": "path", "description": "The recipe id." } ] }, "docs": "Get a recipe's ingredient list." }, { "info": { "name": "Nutrition by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/nutritionWidget.json", "params": [ { "name": "id", "value": "1003464", "type": "path", "description": "The recipe id." } ] }, "docs": "Get a recipe's nutrition data." }, { "info": { "name": "Recipe Nutrition by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/nutritionWidget.png", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." } ] }, "docs": "Visualize a recipe's nutritional information as an image." }, { "info": { "name": "Recipe Nutrition Label Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/nutritionLabel", "params": [ { "name": "id", "value": "641166", "type": "path", "description": "The recipe id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Get a recipe's nutrition label as an HTML widget." }, { "info": { "name": "Recipe Nutrition Label Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/nutritionLabel.png", "params": [ { "name": "id", "value": "641166", "type": "path", "description": "The recipe id." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Get a recipe's nutrition label as an image." }, { "info": { "name": "Get Analyzed Recipe Instructions", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/analyzedInstructions", "params": [ { "name": "id", "value": "324694", "type": "path", "description": "The recipe id." }, { "name": "stepBreakdown", "value": "true", "type": "query", "description": "Whether to break down the recipe steps even more." } ] }, "docs": "Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required." }, { "info": { "name": "Extract Recipe from Website", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/extract", "params": [ { "name": "url", "value": "https://foodista.com/recipe/ZHK4KPB6/chocolate-crinkle-cookies", "type": "query", "description": "The URL of the recipe page." }, { "name": "forceExtraction", "value": "true", "type": "query", "description": "If true, the extraction will be triggered whether we already know the recipe or not. Use this only if information is missing as this operation is slower." }, { "name": "analyze", "value": "false", "type": "query", "description": "If true, the recipe will be analyzed and classified resolving in more data such as cuisines, dish types, and more." }, { "name": "includeNutrition", "value": "", "type": "query", "description": "Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe, just multiply by the number of servings." }, { "name": "includeTaste", "value": "", "type": "query", "description": "Whether taste data should be added to correctly parsed ingredients." } ] }, "docs": "This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website." }, { "info": { "name": "Ingredients by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/ingredientWidget", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." }, { "name": "measure", "value": "metric", "type": "query", "description": "Whether the the measures should be 'us' or 'metric'." } ] }, "docs": "Visualize a recipe's ingredient list." }, { "info": { "name": "Recipe Taste by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/tasteWidget", "params": [ { "name": "id", "value": "69095", "type": "path", "description": "The recipe id." }, { "name": "normalize", "value": "true", "type": "query", "description": "Whether to normalize to the strongest taste." }, { "name": "rgb", "value": "", "type": "query", "description": "Red, green, blue values for the chart color." } ] }, "docs": "Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty." }, { "info": { "name": "Equipment by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/equipmentWidget", "params": [ { "name": "id", "value": "44860", "type": "path", "description": "The recipe id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." } ] }, "docs": "Visualize a recipe's equipment list." }, { "info": { "name": "Price Breakdown by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/priceBreakdownWidget", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." } ] }, "docs": "Visualize a recipe's price breakdown." }, { "info": { "name": "Recipe Taste Widget", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizeTaste", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "ingredientList", "value": "" }, { "name": "normalize", "value": "" }, { "name": "rgb", "value": "" } ] } }, "docs": "Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint!" }, { "info": { "name": "Recipe Nutrition Widget", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizeNutrition", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "ingredientList", "value": "" }, { "name": "servings", "value": "" }, { "name": "defaultCss", "value": "" }, { "name": "showBacklink", "value": "" } ] } }, "docs": "Visualize a recipe's nutritional information as HTML including CSS." }, { "info": { "name": "Price Breakdown Widget", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizePriceEstimator", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "ingredientList", "value": "" }, { "name": "servings", "value": "" }, { "name": "mode", "value": "" }, { "name": "defaultCss", "value": "" }, { "name": "showBacklink", "value": "" } ] } }, "docs": "Visualize the price breakdown of a recipe." }, { "info": { "name": "Equipment Widget", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizeEquipment", "body": { "type": "form-urlencoded", "data": [ { "name": "instructions", "value": "" }, { "name": "view", "value": "" }, { "name": "defaultCss", "value": "" }, { "name": "showBacklink", "value": "" } ] } }, "docs": "Visualize the equipment used to make a recipe." }, { "info": { "name": "Analyze Recipe", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/analyze", "params": [ { "name": "language", "value": "en", "type": "query", "description": "The input language, either \"en\" or \"de\"." }, { "name": "includeNutrition", "value": "false", "type": "query", "description": "Whether nutrition data should be added to correctly parsed ingredients." }, { "name": "includeTaste", "value": "false", "type": "query", "description": "Whether taste data should be added to correctly parsed ingredients." } ], "body": { "type": "json", "data": "{}" } }, "docs": "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." }, { "info": { "name": "Summarize Recipe", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/summary", "params": [ { "name": "id", "value": "4632", "type": "path", "description": "The recipe id." } ] }, "docs": "Automatically generate a short description that summarizes key information about the recipe." }, { "info": { "name": "Create Recipe Card", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/card", "params": [ { "name": "id", "value": "4632", "type": "path", "description": "The recipe id." }, { "name": "mask", "value": "ellipseMask", "type": "query", "description": "The mask to put over the recipe image (\"ellipseMask\", \"diamondMask\", \"starMask\", \"heartMask\", \"potMask\", \"fishMask\")." }, { "name": "backgroundImage", "value": "background1", "type": "query", "description": "The background image (\"none\",\"background1\", or \"background2\")." }, { "name": "backgroundColor", "value": "ffffff", "type": "query", "description": "The background color for the recipe card as a hex-string." }, { "name": "fontColor", "value": "333333", "type": "query", "description": "The font color for the recipe card as a hex-string." } ] }, "docs": "Generate a recipe card for a recipe." }, { "info": { "name": "Create Recipe Card", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizeRecipe", "body": { "type": "multipart-form", "data": [ { "name": "title", "type": "text", "value": "" }, { "name": "ingredients", "type": "text", "value": "" }, { "name": "instructions", "type": "text", "value": "" }, { "name": "readyInMinutes", "type": "text", "value": "" }, { "name": "servings", "type": "text", "value": "" }, { "name": "mask", "type": "text", "value": "" }, { "name": "backgroundImage", "type": "text", "value": "" }, { "name": "image", "type": "text", "value": "" }, { "name": "imageUrl", "type": "text", "value": "" }, { "name": "author", "type": "text", "value": "" }, { "name": "backgroundColor", "type": "text", "value": "" }, { "name": "fontColor", "type": "text", "value": "" }, { "name": "source", "type": "text", "value": "" } ] } }, "docs": "Generate a recipe card for a recipe." }, { "info": { "name": "Analyze Recipe Instructions", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/analyzeInstructions", "body": { "type": "form-urlencoded", "data": [ { "name": "instructions", "value": "" } ] } }, "docs": "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." }, { "info": { "name": "Classify Cuisine", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/cuisine", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "title", "value": "" }, { "name": "ingredientList", "value": "" } ] } }, "docs": "Classify the recipe's cuisine." }, { "info": { "name": "Analyze a Recipe Search Query", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/queries/analyze", "params": [ { "name": "q", "value": "salmon with fusilli and no nuts", "type": "query", "description": "The recipe search query." } ] }, "docs": "Parse a recipe search query to find out its intention." }, { "info": { "name": "Convert Amounts", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/convert", "params": [ { "name": "ingredientName", "value": "flour", "type": "query", "description": "The ingredient which you want to convert." }, { "name": "sourceAmount", "value": "2.5", "type": "query", "description": "The amount from which you want to convert, e.g. the 2.5 in \"2.5 cups of flour to grams\"." }, { "name": "sourceUnit", "value": "cups", "type": "query", "description": "The unit from which you want to convert, e.g. the grams in \"2.5 cups of flour to grams\". You can also use \"piece\", e.g. \"3.4 oz tomatoes to piece\"" }, { "name": "targetUnit", "value": "grams", "type": "query", "description": "The unit to which you want to convert, e.g. the grams in \"2.5 cups of flour to grams\". You can also use \"piece\", e.g. \"3.4 oz tomatoes to piece\"" } ] }, "docs": "Convert amounts like \"2 cups of flour to grams\"." }, { "info": { "name": "Parse Ingredients", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/parseIngredients", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "ingredientList", "value": "" }, { "name": "servings", "value": "" }, { "name": "includeNutrition", "value": "" } ] } }, "docs": "Extract an ingredient from plain text." }, { "info": { "name": "Recipe Nutrition by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/nutritionWidget", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." } ] }, "docs": "Visualize a recipe's nutritional information as HTML including CSS." }, { "info": { "name": "Guess Nutrition by Dish Name", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/guessNutrition", "params": [ { "name": "title", "value": "Spaghetti Aglio et Olio", "type": "query", "description": "The title of the dish." } ] }, "docs": "Estimate the macronutrients of a dish based on its title." }, { "info": { "name": "Compute Glycemic Load", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/food/ingredients/glycemicLoad", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load." }, { "info": { "name": "Quick Answer", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/quickAnswer", "params": [ { "name": "q", "value": "How much vitamin c is in 2 apples?", "type": "query", "description": "The nutrition related question." } ] }, "docs": "Answer a nutrition related natural language question." } ] }, { "info": { "name": "Ingredients", "type": "folder" }, "items": [ { "info": { "name": "Ingredients by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/recipes/:id/ingredientWidget.png", "params": [ { "name": "id", "value": "1082038", "type": "path", "description": "The recipe id." }, { "name": "measure", "value": "metric", "type": "query", "description": "Whether the the measures should be 'us' or 'metric'." } ] }, "docs": "Visualize a recipe's ingredient list." }, { "info": { "name": "Ingredients Widget", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/recipes/visualizeIngredients", "params": [ { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ], "body": { "type": "form-urlencoded", "data": [ { "name": "ingredientList", "value": "" }, { "name": "servings", "value": "" }, { "name": "measure", "value": "" }, { "name": "view", "value": "" }, { "name": "defaultCss", "value": "" }, { "name": "showBacklink", "value": "" } ] } }, "docs": "Visualize ingredients of a recipe. You can play around with that endpoint!" }, { "info": { "name": "Get Ingredient Information", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/:id/information", "params": [ { "name": "id", "value": "9266", "type": "path", "description": "The ingredient id." }, { "name": "amount", "value": "150", "type": "query", "description": "The amount of this ingredient." }, { "name": "unit", "value": "grams", "type": "query", "description": "The unit for the given amount." } ] }, "docs": "Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle." }, { "info": { "name": "Compute Ingredient Amount", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/:id/amount", "params": [ { "name": "id", "value": "9266", "type": "path", "description": "The id of the ingredient you want the amount for." }, { "name": "nutrient", "value": "protein", "type": "query", "description": "The target nutrient. See a list of supported nutrients." }, { "name": "target", "value": "2", "type": "query", "description": "The target number of the given nutrient." }, { "name": "unit", "value": "oz", "type": "query", "description": "The target unit." } ] }, "docs": "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?" }, { "info": { "name": "Autocomplete Ingredient Search", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/autocomplete", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." }, { "name": "metaInformation", "value": "false", "type": "query", "description": "Whether to return more meta information about the ingredients." }, { "name": "intolerances", "value": "egg", "type": "query", "description": "A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the intolerances entered. See a full list of supported intolerances." }, { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ] }, "docs": "Autocomplete the entry of an ingredient." }, { "info": { "name": "Ingredient Search", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/search", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "addChildren", "value": "true", "type": "query", "description": "Whether to add children of found foods." }, { "name": "minProteinPercent", "value": "10", "type": "query", "description": "The minimum percentage of protein the food must have (between 0 and 100)." }, { "name": "maxProteinPercent", "value": "90", "type": "query", "description": "The maximum percentage of protein the food can have (between 0 and 100)." }, { "name": "minFatPercent", "value": "10", "type": "query", "description": "The minimum percentage of fat the food must have (between 0 and 100)." }, { "name": "maxFatPercent", "value": "90", "type": "query", "description": "The maximum percentage of fat the food can have (between 0 and 100)." }, { "name": "minCarbsPercent", "value": "10", "type": "query", "description": "The minimum percentage of carbs the food must have (between 0 and 100)." }, { "name": "maxCarbsPercent", "value": "90", "type": "query", "description": "The maximum percentage of carbs the food can have (between 0 and 100)." }, { "name": "metaInformation", "value": "false", "type": "query", "description": "Whether to return more meta information about the ingredients." }, { "name": "intolerances", "value": "egg", "type": "query", "description": "A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the intolerances entered. See a full list of supported intolerances." }, { "name": "sort", "value": "calories", "type": "query", "description": "The strategy to sort recipes by. See a full list of supported sorting options." }, { "name": "sortDirection", "value": "asc", "type": "query", "description": "The direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending)." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." }, { "name": "language", "value": "", "type": "query", "description": "The language of the input. Either 'en' or 'de'." } ] }, "docs": "Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.)." }, { "info": { "name": "Get Ingredient Substitutes", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/substitutes", "params": [ { "name": "ingredientName", "value": "butter", "type": "query", "description": "The name of the ingredient you want to replace." } ] }, "docs": "Search for substitutes for a given ingredient." }, { "info": { "name": "Get Ingredient Substitutes by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/ingredients/:id/substitutes", "params": [ { "name": "id", "value": "1001", "type": "path", "description": "The id of the ingredient you want substitutes for." } ] }, "docs": "Search for substitutes for a given ingredient." }, { "info": { "name": "Map Ingredients to Grocery Products", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/food/ingredients/map", "body": { "type": "json", "data": "{}" } }, "docs": "Map a set of ingredients to products you can buy in the grocery store." } ] }, { "info": { "name": "Products", "type": "folder" }, "items": [ { "info": { "name": "Search Grocery Products", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/search", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "minCalories", "value": "50", "type": "query", "description": "The minimum amount of calories the product must have." }, { "name": "maxCalories", "value": "800", "type": "query", "description": "The maximum amount of calories the product can have." }, { "name": "minCarbs", "value": "10", "type": "query", "description": "The minimum amount of carbohydrates in grams the product must have." }, { "name": "maxCarbs", "value": "100", "type": "query", "description": "The maximum amount of carbohydrates in grams the product can have." }, { "name": "minProtein", "value": "10", "type": "query", "description": "The minimum amount of protein in grams the product must have." }, { "name": "maxProtein", "value": "100", "type": "query", "description": "The maximum amount of protein in grams the product can have." }, { "name": "minFat", "value": "1", "type": "query", "description": "The minimum amount of fat in grams the product must have." }, { "name": "maxFat", "value": "100", "type": "query", "description": "The maximum amount of fat in grams the product can have." }, { "name": "addProductInformation", "value": "true", "type": "query", "description": "If set to true, you get more information about the products returned." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Search packaged food products, such as frozen pizza or Greek yogurt." }, { "info": { "name": "Search Grocery Products by UPC", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/upc/:upc", "params": [ { "name": "upc", "value": "041631000564", "type": "path", "description": "The product's UPC." } ] }, "docs": "Get information about a packaged food using its UPC." }, { "info": { "name": "Get Product Information", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/:id", "params": [ { "name": "id", "value": "22347", "type": "path", "description": "The id of the packaged food." } ] }, "docs": "Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving." }, { "info": { "name": "Get Comparable Products", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/upc/:upc/comparable", "params": [ { "name": "upc", "value": "33698816271", "type": "path", "description": "The UPC of the product for which you want to find comparable products." } ] }, "docs": "Find comparable products to the given one." }, { "info": { "name": "Autocomplete Product Search", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/suggest", "params": [ { "name": "query", "value": "chicke", "type": "query", "description": "The (partial) search query." }, { "name": "number", "value": "10", "type": "query", "description": "The number of results to return (between 1 and 25)." } ] }, "docs": "Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only." }, { "info": { "name": "Product Nutrition by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/:id/nutritionWidget", "params": [ { "name": "id", "value": "7657", "type": "path", "description": "The id of the product." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." } ] }, "docs": "Visualize a product's nutritional information as HTML including CSS." }, { "info": { "name": "Product Nutrition by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/:id/nutritionWidget.png", "params": [ { "name": "id", "value": "7657", "type": "path", "description": "The id of the product." } ] }, "docs": "Visualize a product's nutritional information as an image." }, { "info": { "name": "Product Nutrition Label Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/:id/nutritionLabel", "params": [ { "name": "id", "value": "22347", "type": "path", "description": "The product id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Get a product's nutrition label as an HTML widget." }, { "info": { "name": "Product Nutrition Label Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/products/:id/nutritionLabel.png", "params": [ { "name": "id", "value": "22347", "type": "path", "description": "The product id." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Get a product's nutrition label as an image." }, { "info": { "name": "Classify Grocery Product", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/food/products/classify", "params": [ { "name": "locale", "value": "en_US", "type": "query", "description": "The display name of the returned category, supported is en_US (for American English) and en_GB (for British English)." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint allows you to match a packaged food to a basic category, e.g. a specific brand of milk to the category milk." }, { "info": { "name": "Classify Grocery Product Bulk", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/food/products/classifyBatch", "params": [ { "name": "locale", "value": "en_US", "type": "query", "description": "The display name of the returned category, supported is en_US (for American English) and en_GB (for British English)." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Provide a set of product jsons, get back classified products." } ] }, { "info": { "name": "Misc", "type": "folder" }, "items": [ { "info": { "name": "Search Custom Foods", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/customFoods/search", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "username", "value": "dsky", "type": "query", "description": "The username." }, { "name": "hash", "value": "4b5v4398573406", "type": "query", "description": "The private hash for the username." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Search custom foods in a user's account." }, { "info": { "name": "Image Classification by URL", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/images/classify", "params": [ { "name": "imageUrl", "value": "https://spoonacular.com/recipeImages/635350-240x150.jpg", "type": "query", "description": "The URL of the image to be classified." } ] }, "docs": "Classify a food image." }, { "info": { "name": "Image Analysis by URL", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/images/analyze", "params": [ { "name": "imageUrl", "value": "https://spoonacular.com/recipeImages/635350-240x150.jpg", "type": "query", "description": "The URL of the image to be analyzed." } ] }, "docs": "Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes." }, { "info": { "name": "Detect Food in Text", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/food/detect", "body": { "type": "form-urlencoded", "data": [ { "name": "text", "value": "" } ] } }, "docs": "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." }, { "info": { "name": "Search Site Content", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/site/search", "params": [ { "name": "query", "value": "past", "type": "query", "description": "The query to search for. You can also use partial queries such as \"spagh\" to already find spaghetti recipes, articles, grocery products, and other content." } ] }, "docs": "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." }, { "info": { "name": "Search All Food", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/search", "params": [ { "name": "query", "value": "apple", "type": "query", "description": "The search query." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos." }, { "info": { "name": "Search Food Videos", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/videos/search", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "type", "value": "main course", "type": "query", "description": "The type of the recipes. See a full list of supported meal types." }, { "name": "cuisine", "value": "italian", "type": "query", "description": "The cuisine(s) of the recipes. One or more, comma separated. See a full list of supported cuisines." }, { "name": "diet", "value": "vegetarian", "type": "query", "description": "The diet for which the recipes must be suitable. See a full list of supported diets." }, { "name": "includeIngredients", "value": "tomato,cheese", "type": "query", "description": "A comma-separated list of ingredients that the recipes should contain." }, { "name": "excludeIngredients", "value": "eggs", "type": "query", "description": "A comma-separated list of ingredients or ingredient types that the recipes must not contain." }, { "name": "minLength", "value": "0", "type": "query", "description": "Minimum video length in seconds." }, { "name": "maxLength", "value": "999", "type": "query", "description": "Maximum video length in seconds." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Find recipe and other food related videos." }, { "info": { "name": "Random Food Joke", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/jokes/random" }, "docs": "Get a random joke that is related to food. Caution: this is an endpoint for adults!" }, { "info": { "name": "Random Food Trivia", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/trivia/random" }, "docs": "Returns random food trivia." }, { "info": { "name": "Talk to Chatbot", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/converse", "params": [ { "name": "text", "value": "donut recipes", "type": "query", "description": "The request / question / answer from the user to the chatbot." }, { "name": "contextId", "value": "342938", "type": "query", "description": "An arbitrary globally unique id for your conversation. The conversation can contain states so you should pass your context id if you want the bot to be able to remember the conversation." } ] }, "docs": "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." }, { "info": { "name": "Conversation Suggests", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/converse/suggest", "params": [ { "name": "query", "value": "tell", "type": "query", "description": "A (partial) query from the user. The endpoint will return if it matches topics it can talk about." }, { "name": "number", "value": "5", "type": "query", "description": "The number of suggestions to return (between 1 and 25)." } ] }, "docs": "This endpoint returns suggestions for things the user can say or ask the chatbot." } ] }, { "info": { "name": "Menu Items", "type": "folder" }, "items": [ { "info": { "name": "Autocomplete Menu Item Search", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/suggest", "params": [ { "name": "query", "value": "chicke", "type": "query", "description": "The (partial) search query." }, { "name": "number", "value": "10", "type": "query", "description": "The number of results to return (between 1 and 25)." } ] }, "docs": "Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only." }, { "info": { "name": "Search Menu Items", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/search", "params": [ { "name": "query", "value": "", "type": "query", "description": "The (natural language) search query." }, { "name": "minCalories", "value": "50", "type": "query", "description": "The minimum amount of calories the menu item must have." }, { "name": "maxCalories", "value": "800", "type": "query", "description": "The maximum amount of calories the menu item can have." }, { "name": "minCarbs", "value": "10", "type": "query", "description": "The minimum amount of carbohydrates in grams the menu item must have." }, { "name": "maxCarbs", "value": "100", "type": "query", "description": "The maximum amount of carbohydrates in grams the menu item can have." }, { "name": "minProtein", "value": "10", "type": "query", "description": "The minimum amount of protein in grams the menu item must have." }, { "name": "maxProtein", "value": "100", "type": "query", "description": "The maximum amount of protein in grams the menu item can have." }, { "name": "minFat", "value": "1", "type": "query", "description": "The minimum amount of fat in grams the menu item must have." }, { "name": "maxFat", "value": "100", "type": "query", "description": "The maximum amount of fat in grams the menu item can have." }, { "name": "addMenuItemInformation", "value": "true", "type": "query", "description": "If set to true, you get more information about the menu items returned." }, { "name": "offset", "value": "", "type": "query", "description": "The number of results to skip (between 0 and 900)." }, { "name": "number", "value": "", "type": "query", "description": "The maximum number of items to return (between 1 and 100). Defaults to 10." } ] }, "docs": "Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha." }, { "info": { "name": "Get Menu Item Information", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/:id", "params": [ { "name": "id", "value": "424571", "type": "path", "description": "The menu item id." } ] }, "docs": "Use a menu item id to get all available information about a menu item, such as nutrition." }, { "info": { "name": "Menu Item Nutrition by ID Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/:id/nutritionWidget", "params": [ { "name": "id", "value": "1003464", "type": "path", "description": "The menu item id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." } ] }, "docs": "Visualize a menu item's nutritional information as HTML including CSS." }, { "info": { "name": "Menu Item Nutrition by ID Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/:id/nutritionWidget.png", "params": [ { "name": "id", "value": "424571", "type": "path", "description": "The menu item id." } ] }, "docs": "Visualize a menu item's nutritional information as HTML including CSS." }, { "info": { "name": "Menu Item Nutrition Label Widget", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/:id/nutritionLabel", "params": [ { "name": "id", "value": "342313", "type": "path", "description": "The menu item id." }, { "name": "defaultCss", "value": "", "type": "query", "description": "Whether the default CSS should be added to the response." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Visualize a menu item's nutritional label information as HTML including CSS." }, { "info": { "name": "Menu Item Nutrition Label Image", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/menuItems/:id/nutritionLabel.png", "params": [ { "name": "id", "value": "342313", "type": "path", "description": "The menu item id." }, { "name": "showOptionalNutrients", "value": "false", "type": "query", "description": "Whether to show optional nutrients." }, { "name": "showZeroValues", "value": "false", "type": "query", "description": "Whether to show zero values." }, { "name": "showIngredients", "value": "false", "type": "query", "description": "Whether to show a list of ingredients." } ] }, "docs": "Visualize a menu item's nutritional label information as an image." }, { "info": { "name": "Search Restaurants", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/restaurants/search", "params": [ { "name": "query", "value": "beach cafe", "type": "query", "description": "The search query." }, { "name": "lat", "value": "37.7786357", "type": "query", "description": "The latitude of the user's location." }, { "name": "lng", "value": "-122.3918135", "type": "query", "description": "The longitude of the user's location.\"." }, { "name": "distance", "value": "2", "type": "query", "description": "The distance around the location in miles." }, { "name": "budget", "value": "20", "type": "query", "description": "The user's budget for a meal in USD." }, { "name": "cuisine", "value": "italian", "type": "query", "description": "The cuisine of the restaurant." }, { "name": "min-rating", "value": "4.4", "type": "query", "description": "The minimum rating of the restaurant between 0 and 5." }, { "name": "is-open", "value": "true", "type": "query", "description": "Whether the restaurant must be open at the time of search." }, { "name": "sort", "value": "distance", "type": "query", "description": "How to sort the results, one of the following 'cheapest', 'fastest', 'rating', 'distance' or the default 'relevance'." }, { "name": "page", "value": "0", "type": "query", "description": "The page number of results." } ] }, "docs": "Search through thousands of restaurants (in North America) by location, cuisine, budget, and more." } ] }, { "info": { "name": "Meal Planning", "type": "folder" }, "items": [ { "info": { "name": "Generate Meal Plan", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/mealplanner/generate", "params": [ { "name": "timeFrame", "value": "day", "type": "query", "description": "Either for one \"day\" or an entire \"week\"." }, { "name": "targetCalories", "value": "2000", "type": "query", "description": "What is the caloric target for one day? The meal plan generator will try to get as close as possible to that goal." }, { "name": "diet", "value": "vegetarian", "type": "query", "description": "Enter a diet that the meal plan has to adhere to. See a full list of supported diets." }, { "name": "exclude", "value": "shellfish, olives", "type": "query", "description": "A comma-separated list of allergens or ingredients that must be excluded." } ] }, "docs": "Generate a meal plan with three meals per day (breakfast, lunch, and dinner)." }, { "info": { "name": "Get Meal Plan Week", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/mealplanner/:username/week/:start_date", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "start_date", "value": "2020-06-01", "type": "path", "description": "The start date of the meal planned week in the format yyyy-mm-dd." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "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." }, { "info": { "name": "Clear Meal Plan Day", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spoonacular.com/mealplanner/:username/day/:date", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "date", "value": "2020-06-01", "type": "path", "description": "The date in the format yyyy-mm-dd." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Delete all planned items from the user's meal plan for a specific day." }, { "info": { "name": "Add to Meal Plan", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/mealplanner/:username/items", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add an item to the user's meal plan." }, { "info": { "name": "Delete from Meal Plan", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spoonacular.com/mealplanner/:username/items/:id", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "id", "value": "15678", "type": "path", "description": "The shopping list item id." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Delete an item from the user's meal plan." }, { "info": { "name": "Get Meal Plan Templates", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/mealplanner/:username/templates", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Get meal plan templates from user or public ones." }, { "info": { "name": "Add Meal Plan Template", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/mealplanner/:username/templates", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "hash", "value": "4b5v4398573406", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Add a meal plan template for a user." }, { "info": { "name": "Get Meal Plan Template", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/mealplanner/:username/templates/:id", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "id", "value": "15678", "type": "path", "description": "The shopping list item id." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Get information about a meal plan template." }, { "info": { "name": "Delete Meal Plan Template", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spoonacular.com/mealplanner/:username/templates/:id", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "id", "value": "15678", "type": "path", "description": "The shopping list item id." }, { "name": "hash", "value": "4b5v4398573406", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Delete a meal plan template for a user." }, { "info": { "name": "Get Shopping List", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/mealplanner/:username/shopping-list", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Get the current shopping list for the given user." }, { "info": { "name": "Generate Shopping List", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/mealplanner/:username/shopping-list/:start_date/:end_date", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "start_date", "value": "2020-06-01", "type": "path", "description": "The start date in the format yyyy-mm-dd." }, { "name": "end_date", "value": "2020-06-07", "type": "path", "description": "The end date in the format yyyy-mm-dd." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Generate the shopping list for a user from the meal planner in a given time frame." }, { "info": { "name": "Connect User", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/users/connect", "body": { "type": "json", "data": "{}" } }, "docs": "In order to call user-specific endpoints, you need to connect your app's users to spoonacular users." }, { "info": { "name": "Add to Shopping List", "type": "http" }, "http": { "method": "POST", "url": "https://api.spoonacular.com/mealplanner/:username/shopping-list/items", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add an item to the current shopping list of a user." }, { "info": { "name": "Delete from Shopping List", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spoonacular.com/mealplanner/:username/shopping-list/items/:id", "params": [ { "name": "username", "value": "dsky", "type": "path", "description": "The username." }, { "name": "id", "value": "15678", "type": "path", "description": "The shopping list item id." }, { "name": "hash", "value": "", "type": "query", "description": "The private hash for the username." } ] }, "docs": "Delete an item from the current shopping list of the user." } ] }, { "info": { "name": "Wine", "type": "folder" }, "items": [ { "info": { "name": "Dish Pairing for Wine", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/wine/dishes", "params": [ { "name": "wine", "value": "malbec", "type": "query", "description": "The type of wine that should be paired, e.g. \"merlot\", \"riesling\", or \"malbec\"." } ] }, "docs": "Find a dish that goes well with a given wine." }, { "info": { "name": "Wine Pairing", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/wine/pairing", "params": [ { "name": "food", "value": "steak", "type": "query", "description": "The food to get a pairing for. This can be a dish (\"steak\"), an ingredient (\"salmon\"), or a cuisine (\"italian\")." }, { "name": "maxPrice", "value": "50", "type": "query", "description": "The maximum price for the specific wine recommendation in USD." } ] }, "docs": "Find a wine that goes well with a food. Food can be a dish name (\"steak\"), an ingredient name (\"salmon\"), or a cuisine (\"italian\")." }, { "info": { "name": "Wine Description", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/wine/description", "params": [ { "name": "wine", "value": "merlot", "type": "query", "description": "The name of the wine that should be paired, e.g. \"merlot\", \"riesling\", or \"malbec\"." } ] }, "docs": "Get a simple description of a certain wine, e.g. \"malbec\", \"riesling\", or \"merlot\"." }, { "info": { "name": "Wine Recommendation", "type": "http" }, "http": { "method": "GET", "url": "https://api.spoonacular.com/food/wine/recommendation", "params": [ { "name": "wine", "value": "merlot", "type": "query", "description": "The type of wine to get a specific product recommendation for." }, { "name": "maxPrice", "value": "50", "type": "query", "description": "The maximum price for the specific wine recommendation in USD." }, { "name": "minRating", "value": "0.7", "type": "query", "description": "The minimum rating of the recommended wine between 0 and 1. For example, 0.8 equals 4 out of 5 stars." }, { "name": "number", "value": "3", "type": "query", "description": "The number of wine recommendations expected (between 1 and 100)." } ] }, "docs": "Get a specific wine recommendation (concrete product) for a given wine type, e.g. \"merlot\"." } ] } ], "bundled": true }