Spoonacular API

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

food

mealplanner

users

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
• "Create a parseIngredient?" -> POST /recipes/parseIngredients
• "List all nutritionWidget?" -> GET /recipes/{id}/nutritionWidget
• "Create a visualizeIngredient?" -> POST /recipes/visualizeIngredients
• "List all guessNutrition?" -> GET /recipes/guessNutrition
• "List all information?" -> GET /food/ingredients/{id}/information
• "List all amount?" -> GET /food/ingredients/{id}/amount
• "Create a glycemicLoad?" -> POST /food/ingredients/glycemicLoad
• "Search autocomplete?" -> GET /food/ingredients/autocomplete
• "Search search?" -> GET /food/ingredients/search
• "List all substitutes?" -> GET /food/ingredients/substitutes
• "List all substitutes?" -> GET /food/ingredients/{id}/substitutes
• "Search search?" -> GET /food/products/search
• "Get upc details?" -> GET /food/products/upc/{upc}
• "Search search?" -> GET /food/customFoods/search
• "Get product details?" -> GET /food/products/{id}
• "List all comparable?" -> GET /food/products/upc/{upc}/comparable
• "Search suggest?" -> GET /food/products/suggest
• "List all nutritionWidget?" -> GET /food/products/{id}/nutritionWidget
• "List all nutritionWidget.png?" -> GET /food/products/{id}/nutritionWidget.png
• "List all nutritionLabel?" -> GET /food/products/{id}/nutritionLabel
• "List all nutritionLabel.png?" -> GET /food/products/{id}/nutritionLabel.png
• "Create a classify?" -> POST /food/products/classify
• "Create a classifyBatch?" -> POST /food/products/classifyBatch
• "Create a map?" -> POST /food/ingredients/map
• "Search suggest?" -> GET /food/menuItems/suggest
• "Search search?" -> GET /food/menuItems/search
• "Get menuItem details?" -> GET /food/menuItems/{id}
• "List all nutritionWidget?" -> GET /food/menuItems/{id}/nutritionWidget
• "List all nutritionWidget.png?" -> GET /food/menuItems/{id}/nutritionWidget.png
• "List all nutritionLabel?" -> GET /food/menuItems/{id}/nutritionLabel
• "List all nutritionLabel.png?" -> GET /food/menuItems/{id}/nutritionLabel.png
• "List all generate?" -> GET /mealplanner/generate
• "Get week details?" -> GET /mealplanner/{username}/week/{start-date}
• "Delete a day?" -> DELETE /mealplanner/{username}/day/{date}
• "Create a item?" -> POST /mealplanner/{username}/items
• "Delete a item?" -> DELETE /mealplanner/{username}/items/{id}
• "List all templates?" -> GET /mealplanner/{username}/templates
• "Create a template?" -> POST /mealplanner/{username}/templates
• "Get template details?" -> GET /mealplanner/{username}/templates/{id}
• "Delete a template?" -> DELETE /mealplanner/{username}/templates/{id}
• "List all shopping-list?" -> GET /mealplanner/{username}/shopping-list
• "Create a connect?" -> POST /users/connect
• "Create a item?" -> POST /mealplanner/{username}/shopping-list/items
• "Delete a item?" -> DELETE /mealplanner/{username}/shopping-list/items/{id}
• "Search search?" -> GET /food/restaurants/search
• "List all dishes?" -> GET /food/wine/dishes
• "List all pairing?" -> GET /food/wine/pairing
• "List all description?" -> GET /food/wine/description
• "List all recommendation?" -> GET /food/wine/recommendation
• "List all classify?" -> GET /food/images/classify
• "List all analyze?" -> GET /food/images/analyze
• "Search quickAnswer?" -> GET /recipes/quickAnswer
• "Create a detect?" -> POST /food/detect
• "Search search?" -> GET /food/site/search
• "Search search?" -> GET /food/search
• "Search search?" -> GET /food/videos/search
• "List all random?" -> GET /food/jokes/random
• "List all random?" -> GET /food/trivia/random
• "List all converse?" -> GET /food/converse
• "Search suggest?" -> GET /food/converse/suggest
• "How to authenticate?" -> See Auth section

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