Open documentation ↗Overview
Recipes, Food Products, and Meal Planning
Spoonacular is a food & drink API from spoonacular.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 99 endpoints.
At a glance
- Authentication
- API key
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Food & Drink
- Base URL
https://api.spoonacular.com- Version
- 1.1
- Endpoints
- 99
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-06
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.spoonacular.com/food/converse" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"const response = await fetch("https://api.spoonacular.com/food/converse", {
method: "GET",
headers: {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://api.spoonacular.com/food/converse",
headers={
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /food/converse | Talk to Chatbot |
| GET | /food/converse/suggest | Conversation Suggests |
| GET | /food/customFoods/search | Search Custom Foods |
| POST | /food/detect | Detect Food in Text |
| GET | /food/images/analyze | Image Analysis by URL |
| GET | /food/images/classify | Image Classification by URL |
| GET | /food/ingredients/autocomplete | Autocomplete Ingredient Search |
| POST | /food/ingredients/glycemicLoad | Compute Glycemic Load |
| POST | /food/ingredients/map | Map Ingredients to Grocery Products |
| GET | /food/ingredients/search | Ingredient Search |
| GET | /food/ingredients/substitutes | Get Ingredient Substitutes |
| GET | /food/ingredients/{id}/amount | Compute Ingredient Amount |
| GET | /food/ingredients/{id}/information | Get Ingredient Information |
| GET | /food/ingredients/{id}/substitutes | Get Ingredient Substitutes by ID |
| GET | /food/jokes/random | Random Food Joke |
| GET | /food/menuItems/search | Search Menu Items |
| GET | /food/menuItems/suggest | Autocomplete Menu Item Search |
| GET | /food/menuItems/{id} | Get Menu Item Information |
| GET | /food/menuItems/{id}/nutritionLabel | Menu Item Nutrition Label Widget |
| GET | /food/menuItems/{id}/nutritionLabel.png | Menu Item Nutrition Label Image |
| GET | /food/menuItems/{id}/nutritionWidget | Menu Item Nutrition by ID Widget |
| GET | /food/menuItems/{id}/nutritionWidget.png | Menu Item Nutrition by ID Image |
| POST | /food/products/classify | Classify Grocery Product |
| POST | /food/products/classifyBatch | Classify Grocery Product Bulk |
| GET | /food/products/search | Search Grocery Products |
| GET | /food/products/suggest | Autocomplete Product Search |
| GET | /food/products/upc/{upc} | Search Grocery Products by UPC |
| GET | /food/products/upc/{upc}/comparable | Get Comparable Products |
| GET | /food/products/{id} | Get Product Information |
| GET | /food/products/{id}/nutritionLabel | Product Nutrition Label Widget |
| GET | /food/products/{id}/nutritionLabel.png | Product Nutrition Label Image |
| GET | /food/products/{id}/nutritionWidget | Product Nutrition by ID Widget |
| GET | /food/products/{id}/nutritionWidget.png | Product Nutrition by ID Image |
| GET | /food/restaurants/search | Search Restaurants |
| GET | /food/search | Search All Food |
| GET | /food/site/search | Search Site Content |
| GET | /food/trivia/random | Random Food Trivia |
| GET | /food/videos/search | Search Food Videos |
| GET | /food/wine/description | Wine Description |
| GET | /food/wine/dishes | Dish Pairing for Wine |
| GET | /food/wine/pairing | Wine Pairing |
| GET | /food/wine/recommendation | Wine Recommendation |
| GET | /mealplanner/generate | Generate Meal Plan |
| 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}/shopping-list | Get Shopping List |
| POST | /mealplanner/{username}/shopping-list/items | Add to Shopping List |
| DELETE | /mealplanner/{username}/shopping-list/items/{id} | Delete from Shopping List |
| POST | /mealplanner/{username}/shopping-list/{start-date}/{end-date} | Generate Shopping List |
| 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}/week/{start-date} | Get Meal Plan Week |
| POST | /recipes/analyze | Analyze Recipe |
| POST | /recipes/analyzeInstructions | Analyze Recipe Instructions |
| GET | /recipes/autocomplete | Autocomplete Recipe Search |
| GET | /recipes/complexSearch | Search Recipes |
| GET | /recipes/convert | Convert Amounts |
| POST | /recipes/cuisine | Classify Cuisine |
| GET | /recipes/extract | Extract Recipe from Website |
| GET | /recipes/findByIngredients | Search Recipes by Ingredients |
| GET | /recipes/findByNutrients | Search Recipes by Nutrients |
| GET | /recipes/guessNutrition | Guess Nutrition by Dish Name |
| GET | /recipes/informationBulk | Get Recipe Information Bulk |
| POST | /recipes/parseIngredients | Parse Ingredients |
| GET | /recipes/queries/analyze | Analyze a Recipe Search Query |
| GET | /recipes/quickAnswer | Quick Answer |
| GET | /recipes/random | Get Random Recipes |
| POST | /recipes/visualizeEquipment | Equipment Widget |
| POST | /recipes/visualizeIngredients | Ingredients Widget |
| POST | /recipes/visualizeNutrition | Recipe Nutrition Widget |
| POST | /recipes/visualizePriceEstimator | Price Breakdown Widget |
| POST | /recipes/visualizeRecipe | Create Recipe Card |
| POST | /recipes/visualizeTaste | Recipe Taste Widget |
| GET | /recipes/{id}/analyzedInstructions | Get Analyzed Recipe Instructions |
| GET | /recipes/{id}/card | Create Recipe Card |
| GET | /recipes/{id}/equipmentWidget | Equipment by ID Widget |
| GET | /recipes/{id}/equipmentWidget.json | Equipment by ID |
| GET | /recipes/{id}/equipmentWidget.png | Equipment by ID Image |
| GET | /recipes/{id}/information | Get Recipe Information |
| GET | /recipes/{id}/ingredientWidget | Ingredients by ID Widget |
| GET | /recipes/{id}/ingredientWidget.json | Ingredients by ID |
| GET | /recipes/{id}/ingredientWidget.png | Ingredients by ID Image |
| GET | /recipes/{id}/nutritionLabel | Recipe Nutrition Label Widget |
| GET | /recipes/{id}/nutritionLabel.png | Recipe Nutrition Label Image |
| GET | /recipes/{id}/nutritionWidget | Recipe Nutrition by ID Widget |
| GET | /recipes/{id}/nutritionWidget.json | Nutrition by ID |
| GET | /recipes/{id}/nutritionWidget.png | Recipe Nutrition by ID Image |
| GET | /recipes/{id}/priceBreakdownWidget | Price Breakdown by ID Widget |
| GET | /recipes/{id}/priceBreakdownWidget.json | Price Breakdown by ID |
| GET | /recipes/{id}/priceBreakdownWidget.png | Price Breakdown by ID Image |
| GET | /recipes/{id}/similar | Get Similar Recipes |
| GET | /recipes/{id}/summary | Summarize Recipe |
| GET | /recipes/{id}/tasteWidget | Recipe Taste by ID Widget |
| GET | /recipes/{id}/tasteWidget.json | Taste by ID |
| GET | /recipes/{id}/tasteWidget.png | Recipe Taste by ID Image |
| POST | /users/connect | Connect User |
Questions
Does the Spoonacular API need an API key?
Yes. The Spoonacular API uses API key authentication; the documentation explains how to get credentials.
Does the Spoonacular API support HTTPS?
Yes, the Spoonacular API is served over HTTPS.
How many endpoints does the Spoonacular API have?
Its OpenAPI description lists 99 endpoints in version 1.1. All of them are shown on this page.
What are alternatives to the Spoonacular API?
Other Food & Drink APIs include Open Food Facts, Chomp, 1,000,000+ Recipe and Grocery List API (v2), Edamam nutrition, CalorieNinjas.
Similar food & drink APIs
Compare alternatives →Open Food Facts
Food & DrinkFood Products Database
Chomp
Food & DrinkData about various grocery products and foods
1,000,000+ Recipe and Grocery List API (v2)
Food & Drink#Documentation This is the documentation for the partner endpoint of the BigOven Recipe and Grocery List API. The update brings with it Swagger-based documentation. [Swagger](http://swagger.io) is an emerging standard for describing REST-based APIs, and with this Swagger-compliant endpoint (above), you can make ready-to-go interface libraries for your code via [swagger-codegen](https://github.com/swagger-api/swagger-codegen). For instance, it's easy to generate libraries for Node.js, Java, Ruby, ASP.NET MVC, jQuery, php and more! You can also try out the endpoint calls with your own api_key right here on this page. Be sure to enter your api_key above to use the "Try it out!" buttons on this page. ##Start Here Developers new to the BigOven API should start with this version, not with the legacy API. We'll be making improvements to this API over time, and doing only bug fixes on the v1 API. To pretend you're a BigOven user (for instance, to get your recently viewed recipes or your grocery list), you need to pass in Basic Authentication information in the header, just as with the v1 API. We do now require that you make all calls via https. You need to pass your api_key in with every call, though this can now be done on the header (send a request header "X-BigOven-API-Key" set to your api_key value, e.g., Request["X-BigOven-API-Key"]="your-key-here".) ##Migration Notes For existing partners, we encourage you to [migrate](https://api2.bigoven.com), and while at this writing we have no hard-and-fast termination date for the v1 API, we strongly prefer that you migrate by January 1, 2017. While the changes aren't overly complex, there are several breaking changes, including refactoring of recipe search and results and removal of support for XML. This is not a simply plug-and-play replacement to the v1 API. With respect to an exclusive focus on JSON, the world has spoken, and it prefers JSON for REST-based API's. We've taken numerous steps to refactor the API to make it more REST-compliant. Note that this v2 API will be the preferred API from this point onward, so we encourage developers to migrate to this new format. We have put together some [migration notes](/web/documentation/migration-to-v2) that we encourage you to read carefully. ##Photos See our [photos documentation](https://api2.bigoven.com/web/documentation/recipe-images). For more information on usage of this API, including features, pricing, rate limits, terms and conditions, please visit the [BigOven API website](https://api2.bigoven.com).
Edamam nutrition
Food & DrinkAPI developer portal for Nutrition Analysis, Food Database Lookup, Recipe Search API and others. Choose the API license you need.
CalorieNinjas
Food & DrinkNutrition and calorie data for foods and recipes
Jelly Belly Wiki
Food & DrinkData about Jelly Belly beans- flavores, facts, history and more endpoints
Listed from public-apis (MIT), public-apis database (MIT), APIs.guru (CC0).