September, 2020

Glycemic Index Data

We now have glycemic index and glycemic load data for many ingredients and can compute the total glycemic load for multiple ingredients or a recipe. Check out the dedicated endpoint or just find the data that is now added to the "nutrition" object called "properties", e.g.

"nutrition": {
         "properties": [
                "title": "Glycemic Index",
                "amount": 13.92,
                "unit": ""
                "title": "Glycemic Load",
                "amount": 8.92,
                "unit": ""

Widget Example Code

We have updated all the widget endpoints for visualizing recipe nutrition, equipment, price breakdown, and ingredients and you can use the "play" button in the docs to preview the widgets.

Furthermore, you can find fully working example code that you can copy to your projects which we host on GitHub here: https://github.com/ddsky/spoonacular-widgets

Meal Planning API Updates

In our last release, we introduced our new meal planning API and we were surprised how many of you adopted it so quickly! From the feedback we received we added and improved a couple endpoints:

  • You can add all meals from a certain meal plan template to a user's meal plan with just one API call, see: Add to Meal Plan.
  • You can now clear an entire meal planned day with just one API call, see: Clear Meal Plan Day.
  • Instead of preloading an entire week of planned meals (which can be quite a big json response), you can now load individual days, see: Get Meal Plan Day.
  • Instead of adding meals one by one, you can now pass a list of items to add to the meal planner in a single call, see: Add to Meal Plan.

What else is new?

In our last release, we introduced our new meal planning API and we were surprised how many of you adopted it so quickly! From the feedback we received we added and improved a couple endpoints:

  • You can now search ALL kinds of food, even videos and articles, in a single endpoint.
  • We have published a short guide explaining the wines currently covered by our database. This data is relevant for all wine-related endpoints.

July, 2020

Meal Planning API

We receive a lot of requests from users who want to build their own meal planning tools. To help you achieve this, we have added 11 new endpoints to our API, including Add/Delete from Meal Plan, Get Meal Plan Week, Generate Shopping List, and other highly requested endpoints.

These endpoints are closely connected to our meal planner on spoonacular.com. You can find out more here: https://spoonacular.com/food-api/docs#Working-with-the-Meal-Planner

What else is new?

  • We created a new parameter "addRecipeNutrition" which adds the nutritional information to the recipe search results without needing to call Get Recipe Information for every recipe returned.
  • Get Recipe Information now includes "summary" - an automatically generated text to describe the recipe.
  • We have improved menu item nutrition.
  • RapidAPI published a great article a few months back. If you missed it, here it is: How to Create a Food Website (using the spoonacular API)

May, 2020

New Image Classifier

We have been working on a new set of functionalities that allow you to classify food pictures! Our model is trained on over 15,000 images in 50 classes with a focus on dishes that you can get in a restaurant, such as burgers, fish and chips, and lasagna. To train our model, we picked professional photographs and pictures taken by actual restaurant visitors - see how different these two categories are?

Model Accuracy

How good is our model? After extensive training and evaluation we reached just above 90% accuracy. We also researched other classifiers and studied how well Google, Microsoft, IBM, and other companies focused on image classification work on our dataset. Here's the comparison if you're interested: https://spoonacular.com/food-api/docs#Image-Classification

February, 2020

Recipe Search

We have been working on the speed of the recipe search. The new Complex Recipe Search endpoint is now five times faster.

You can now also sort recipes by a large list of criteria, such as by any macro- or micronutrient, cooking time, price, meta-score, or just random.

The nutritional information for each recipe now also contains the weight per serving:

"weightPerServing": {
    "amount": 269,
    "unit": "g"

Additionally, the nutritional information also includes net carbs, which is defined in the API as total carbohydrates minus the fiber content.

Autocomplete Ingredients

When requesting meta-information from the autocomplete ingredient endpoint, you can now also request a list of possible units for any given ingredient.

For example, if your app allows users to enter ingredients, you might want to let them enter 3 slices of apple instead of just 1 oz of apple. The possible units tell you whether the API recognizes the unit (e.g. slices) and can compute the nutrition correctly. The API does not know "slices" for, say, peanuts, so it is beneficial to let your user only pick units that can be understood.

Grocery Products

Information about grocery products now contains all the nutritional information we have for a product, not just macronutrients. Additionally, we added a description of the product if available and attempt to guess the supermarket aisle where you would expect to find the product.

New Resources & Your Feedback

We have published a list of the top 1,000 ingredients used in recipes and their spoonacular ingredient ids here.

All our SDKs have been recompiled, so make sure you update your SDK if you are using an older one.