spoonacular-api

name	spoonacular-api
description	spoonacular API skill. Use when working with spoonacular for recipes, food, mealplanner. Covers 99 endpoints.
version	1.0.0
generator	lapsh

spoonacular API

API version: 1.1

Auth

ApiKey x-api-key in header

Base URL

https://api.spoonacular.com

Setup

1. Set your API key in the appropriate header
2. GET /recipes/complexSearch -- verify access
3. POST /recipes/visualizeTaste -- create first visualizeTaste

Endpoints

99 endpoints across 4 groups. See references/api-spec.lap for full details.

recipes

Method	Path	Description
GET	/recipes/complexSearch	Search Recipes
GET	/recipes/findByIngredients	Search Recipes by Ingredients
GET	/recipes/findByNutrients	Search Recipes by Nutrients
GET	/recipes/{id}/information	Get Recipe Information
GET	/recipes/informationBulk	Get Recipe Information Bulk
GET	/recipes/{id}/similar	Get Similar Recipes
GET	/recipes/random	Get Random Recipes
GET	/recipes/autocomplete	Autocomplete Recipe Search
GET	/recipes/{id}/tasteWidget.json	Taste by ID
GET	/recipes/{id}/tasteWidget.png	Recipe Taste by ID Image
GET	/recipes/{id}/equipmentWidget.json	Equipment by ID
GET	/recipes/{id}/equipmentWidget.png	Equipment by ID Image
GET	/recipes/{id}/priceBreakdownWidget.json	Price Breakdown by ID
GET	/recipes/{id}/priceBreakdownWidget.png	Price Breakdown by ID Image
GET	/recipes/{id}/ingredientWidget.json	Ingredients by ID
GET	/recipes/{id}/ingredientWidget.png	Ingredients by ID Image
GET	/recipes/{id}/nutritionWidget.json	Nutrition by ID
GET	/recipes/{id}/nutritionWidget.png	Recipe Nutrition by ID Image
GET	/recipes/{id}/nutritionLabel	Recipe Nutrition Label Widget
GET	/recipes/{id}/nutritionLabel.png	Recipe Nutrition Label Image
GET	/recipes/{id}/analyzedInstructions	Get Analyzed Recipe Instructions
GET	/recipes/extract	Extract Recipe from Website
GET	/recipes/{id}/ingredientWidget	Ingredients by ID Widget
GET	/recipes/{id}/tasteWidget	Recipe Taste by ID Widget
GET	/recipes/{id}/equipmentWidget	Equipment by ID Widget
GET	/recipes/{id}/priceBreakdownWidget	Price Breakdown by ID Widget
POST	/recipes/visualizeTaste	Recipe Taste Widget
POST	/recipes/visualizeNutrition	Recipe Nutrition Widget
POST	/recipes/visualizePriceEstimator	Price Breakdown Widget
POST	/recipes/visualizeEquipment	Equipment Widget
POST	/recipes/analyze	Analyze Recipe
GET	/recipes/{id}/summary	Summarize Recipe
GET	/recipes/{id}/card	Create Recipe Card
POST	/recipes/visualizeRecipe	Create Recipe Card
POST	/recipes/analyzeInstructions	Analyze Recipe Instructions
POST	/recipes/cuisine	Classify Cuisine
GET	/recipes/queries/analyze	Analyze a Recipe Search Query
GET	/recipes/convert	Convert Amounts
POST	/recipes/parseIngredients	Parse Ingredients
GET	/recipes/{id}/nutritionWidget	Recipe Nutrition by ID Widget
POST	/recipes/visualizeIngredients	Ingredients Widget
GET	/recipes/guessNutrition	Guess Nutrition by Dish Name
GET	/recipes/quickAnswer	Quick Answer

food

Method	Path	Description
GET	/food/ingredients/{id}/information	Get Ingredient Information
GET	/food/ingredients/{id}/amount	Compute Ingredient Amount
POST	/food/ingredients/glycemicLoad	Compute Glycemic Load
GET	/food/ingredients/autocomplete	Autocomplete Ingredient Search
GET	/food/ingredients/search	Ingredient Search
GET	/food/ingredients/substitutes	Get Ingredient Substitutes
GET	/food/ingredients/{id}/substitutes	Get Ingredient Substitutes by ID
GET	/food/products/search	Search Grocery Products
GET	/food/products/upc/{upc}	Search Grocery Products by UPC
GET	/food/customFoods/search	Search Custom Foods
GET	/food/products/{id}	Get Product Information
GET	/food/products/upc/{upc}/comparable	Get Comparable Products
GET	/food/products/suggest	Autocomplete Product Search
GET	/food/products/{id}/nutritionWidget	Product Nutrition by ID Widget
GET	/food/products/{id}/nutritionWidget.png	Product Nutrition by ID Image
GET	/food/products/{id}/nutritionLabel	Product Nutrition Label Widget
GET	/food/products/{id}/nutritionLabel.png	Product Nutrition Label Image
POST	/food/products/classify	Classify Grocery Product
POST	/food/products/classifyBatch	Classify Grocery Product Bulk
POST	/food/ingredients/map	Map Ingredients to Grocery Products
GET	/food/menuItems/suggest	Autocomplete Menu Item Search
GET	/food/menuItems/search	Search Menu Items
GET	/food/menuItems/{id}

mealplanner

Method	Path	Description
GET	/mealplanner/generate	Generate Meal Plan
GET	/mealplanner/{username}/week/{start-date}	Get Meal Plan Week
DELETE	/mealplanner/{username}/day/{date}	Clear Meal Plan Day
POST	/mealplanner/{username}/items	Add to Meal Plan
DELETE	/mealplanner/{username}/items/{id}	Delete from Meal Plan
GET	/mealplanner/{username}/templates	Get Meal Plan Templates
POST	/mealplanner/{username}/templates	Add Meal Plan Template
GET	/mealplanner/{username}/templates/{id}	Get Meal Plan Template
DELETE	/mealplanner/{username}/templates/{id}	Delete Meal Plan Template
GET	/mealplanner/{username}/shopping-list	Get Shopping List
POST	/mealplanner/{username}/shopping-list/{start-date}/{end-date}	Generate Shopping List
POST	/mealplanner/{username}/shopping-list/items	Add to Shopping List
DELETE	/mealplanner/{username}/shopping-list/items/{id}	Delete from Shopping List

users

Method	Path	Description
POST	/users/connect	Connect User

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Search complexSearch?" -> GET /recipes/complexSearch
• "List all findByIngredients?" -> GET /recipes/findByIngredients
• "List all findByNutrients?" -> GET /recipes/findByNutrients
• "List all information?" -> GET /recipes/{id}/information
• "List all informationBulk?" -> GET /recipes/informationBulk
• "List all similar?" -> GET /recipes/{id}/similar
• "List all random?" -> GET /recipes/random
• "Search autocomplete?" -> GET /recipes/autocomplete
• "List all tasteWidget.json?" -> GET /recipes/{id}/tasteWidget.json
• "List all tasteWidget.png?" -> GET /recipes/{id}/tasteWidget.png
• "List all equipmentWidget.json?" -> GET /recipes/{id}/equipmentWidget.json
• "List all equipmentWidget.png?" -> GET /recipes/{id}/equipmentWidget.png
• "List all priceBreakdownWidget.json?" -> GET /recipes/{id}/priceBreakdownWidget.json
• "List all priceBreakdownWidget.png?" -> GET /recipes/{id}/priceBreakdownWidget.png
• "List all ingredientWidget.json?" -> GET /recipes/{id}/ingredientWidget.json
• "List all ingredientWidget.png?" -> GET /recipes/{id}/ingredientWidget.png
• "List all nutritionWidget.json?" -> GET /recipes/{id}/nutritionWidget.json
• "List all nutritionWidget.png?" -> GET /recipes/{id}/nutritionWidget.png
• "List all nutritionLabel?" -> GET /recipes/{id}/nutritionLabel
• "List all nutritionLabel.png?" -> GET /recipes/{id}/nutritionLabel.png
• "List all analyzedInstructions?" -> GET /recipes/{id}/analyzedInstructions
• "List all extract?" -> GET /recipes/extract
• "List all ingredientWidget?" -> GET /recipes/{id}/ingredientWidget
• "List all tasteWidget?" -> GET /recipes/{id}/tasteWidget
• "List all equipmentWidget?" -> GET /recipes/{id}/equipmentWidget
• "List all priceBreakdownWidget?" -> GET /recipes/{id}/priceBreakdownWidget
• "Create a visualizeTaste?" -> POST /recipes/visualizeTaste
• "Create a visualizeNutrition?" -> POST /recipes/visualizeNutrition
• "Create a visualizePriceEstimator?" -> POST /recipes/visualizePriceEstimator
• "Create a visualizeEquipment?" -> POST /recipes/visualizeEquipment
• "Create a analyze?" -> POST /recipes/analyze
• "List all summary?" -> GET /recipes/{id}/summary
• "List all card?" -> GET /recipes/{id}/card
• "Create a visualizeRecipe?" -> POST /recipes/visualizeRecipe
• "Create a analyzeInstruction?" -> POST /recipes/analyzeInstructions
• "Create a cuisine?" -> POST /recipes/cuisine
• "Search analyze?" -> GET /recipes/queries/analyze
• "List all convert?" -> GET /recipes/convert

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP