← Back to catalog

Social

spoonacular

auto-generated
swirls add spoonacular …
actionPOSTv1.0.0

Add to Meal Plan

Add an item to the user's meal plan.

Source
actionPOSTv1.0.0

Analyze Recipe

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.

Source
actionPOSTv1.0.0

Analyze Recipe Instructions

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.

Source
actionGETv1.0.0

Autocomplete Menu Item Search

Generate suggestions for menu items based on a (partial) query. The matches will be found by looking in the title only.

Source
actionGETv1.0.0

Autocomplete Product Search

Generate suggestions for grocery products based on a (partial) query. The matches will be found by looking in the title only.

Source
actionPOSTv1.0.0

Classify Grocery Product

This endpoint allows you to match a packaged food to a basic category, e.g. a specific brand of milk to the category milk.

Source
actionDELETEv1.0.0

Clear Meal Plan Day

Delete all planned items from the user's meal plan for a specific day.

Source
actionPOSTv1.0.0

Compute Glycemic Load

Retrieve the glycemic index for a list of ingredients and compute the individual and total glycemic load.

Source
actionGETv1.0.0

Compute Ingredient Amount

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?

Source
actionPOSTv1.0.0

Connect User

In order to call user-specific endpoints, you need to connect your app's users to spoonacular users.

Source
actionGETv1.0.0

Conversation Suggests

This endpoint returns suggestions for things the user can say or ask the chatbot.

Source
actionGETv1.0.0

Convert Amounts

Convert amounts like "2 cups of flour to grams".

Source
actionGETv1.0.0

Create Recipe Card

Generate a recipe card for a recipe.

Source
actionPOSTv1.0.0

Detect Food in Text

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.

Source
actionGETv1.0.0

Dish Pairing for Wine

Find a dish that goes well with a given wine.

Source
actionGETv1.0.0

Equipment by ID

Get a recipe's equipment list.

Source
actionPOSTv1.0.0

Equipment Widget

Visualize the equipment used to make a recipe.

Source
actionGETv1.0.0

Extract Recipe from Website

This endpoint lets you extract recipe data such as title, ingredients, and instructions from any properly formatted Website.

Source
actionGETv1.0.0

Generate Meal Plan

Generate a meal plan with three meals per day (breakfast, lunch, and dinner).

Source
actionGETv1.0.0

Get Analyzed Recipe Instructions

Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required.

Source
actionGETv1.0.0

Get Ingredient Information

Use an ingredient id to get all available information about an ingredient, such as its image and supermarket aisle.

Source
actionGETv1.0.0

Get Meal Plan Week

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.

Source
actionGETv1.0.0

Get Menu Item Information

Use a menu item id to get all available information about a menu item, such as nutrition.

Source
actionGETv1.0.0

Get Product Information

Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving.

Source
actionGETv1.0.0

Get Random Recipes

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.

Source
actionGETv1.0.0

Get Recipe Information

Use a recipe id to get full information about a recipe, such as ingredients, nutrition, diet and allergen information, etc.

Source
actionGETv1.0.0

Get Similar Recipes

Find recipes which are similar to the given one.

Source
actionGETv1.0.0

Image Analysis by URL

Analyze a food image. The API tries to classify the image, guess the nutrition, and find a matching recipes.

Source
actionGETv1.0.0

Ingredient Search

Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).

Source
actionGETv1.0.0

Ingredients by ID

Get a recipe's ingredient list.

Source
actionPOSTv1.0.0

Ingredients Widget

Visualize ingredients of a recipe. You can play around with that endpoint!

Source
actionGETv1.0.0

Nutrition by ID

Get a recipe's nutrition data.

Source
actionPOSTv1.0.0

Parse Ingredients

Extract an ingredient from plain text.

Source
actionGETv1.0.0

Quick Answer

Answer a nutrition related natural language question.

Source
actionGETv1.0.0

Random Food Joke

Get a random joke that is related to food. Caution: this is an endpoint for adults!

Source
actionPOSTv1.0.0

Recipe Nutrition Widget

Visualize a recipe's nutritional information as HTML including CSS.

Source
actionGETv1.0.0

Recipe Taste by ID Image

Get a recipe's taste as an image. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Source
actionGETv1.0.0

Recipe Taste by ID Widget

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Source
actionPOSTv1.0.0

Recipe Taste Widget

Visualize a recipe's taste information as HTML including CSS. You can play around with that endpoint!

Source
actionGETv1.0.0

Search All Food

Search all food content with one call. That includes recipes, grocery products, menu items, simple foods (ingredients), and food videos.

Source
actionGETv1.0.0

Search Food Videos

Find recipe and other food related videos.

Source
actionGETv1.0.0

Search Grocery Products

Search packaged food products, such as frozen pizza or Greek yogurt.

Source
actionGETv1.0.0

Search Menu Items

Search over 115,000 menu items from over 800 fast food and chain restaurants. For example, McDonald's Big Mac or Starbucks Mocha.

Source
actionGETv1.0.0

Search Recipes

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.

Source
actionGETv1.0.0

Search Recipes by Ingredients

Ever 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).

Source
actionGETv1.0.0

Search Recipes by Nutrients

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.

Source
actionGETv1.0.0

Search Restaurants

Search through thousands of restaurants (in North America) by location, cuisine, budget, and more.

Source
actionGETv1.0.0

Search Site Content

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.

Source
actionGETv1.0.0

Summarize Recipe

Automatically generate a short description that summarizes key information about the recipe.

Source
actionGETv1.0.0

Talk to Chatbot

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.

Source
actionGETv1.0.0

Taste by ID

Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty.

Source
actionGETv1.0.0

Wine Description

Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot".

Source
actionGETv1.0.0

Wine Pairing

Find a wine that goes well with a food. Food can be a dish name ("steak"), an ingredient name ("salmon"), or a cuisine ("italian").

Source
actionGETv1.0.0

Wine Recommendation

Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot".

Source
Beyond the catalog

Any provider, on request.

01

Request it

Tell us which provider you need, and we will ship it in the registry.

02

Generate it

Point swirls add at an OpenAPI or GraphQL spec. Typed actions for any API you hold credentials for, today.

Request a providerRead the actions docs
acme · integrations
terminal
~/acme $swirls add linear
✓ 12 typed actions · scopes and schemas included
 
~/acme $swirls add https://api.acme.dev/openapi.json
◆ Fetched spec · 38 operations
✓ 6 typed actions · generated from spec