# spoonacular API API

> spoonacular API API on Apizie: 99 endpoints (Talk to Chatbot, Conversation Suggests, Search Custom Foods, Detect Food in Text, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/social-media:spoonacular/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `social-media:spoonacular`
- Category: Social Media
- Status: byok
- Source: https://spoonacular.com/contact
- Page: https://www.apizie.tech/api/social-media/spoonacular
- OpenAPI: https://www.apizie.tech/api/social-media/spoonacular/openapi.json

The spoonacular Nutrition, Recipe, and Food API allows you to access over thousands of recipes, thousands of ingredients, 800,000 food products, over 100,000 menu items, and restaurants. Our food ontology and semantic…

## Endpoints

### Talk to Chatbot
`GET https://www.apizie.tech/v1/social-media:spoonacular/talk-to-chatbot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| text | string | yes | The request / question / answer from the user to the chatbot. |
| contextId | string | no | An arbitrary globally unique id for your conversation. The conversation can contain states so you should pass your context id if you want… |

### Conversation Suggests
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-conversation-suggests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | A (partial) query from the user. The endpoint will return if it matches topics it can talk about. |
| number | number | no | The number of suggestions to return (between 1 and 25). |

### Search Custom Foods
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-custom-foods` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Detect Food in Text
`POST https://www.apizie.tech/v1/social-media:spoonacular/detect-food-in-text` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Image Analysis by URL
`GET https://www.apizie.tech/v1/social-media:spoonacular/image-analysis-by-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| imageUrl | string | yes | The URL of the image to be analyzed. |

### Image Classification by URL
`GET https://www.apizie.tech/v1/social-media:spoonacular/image-classification-by-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| imageUrl | string | yes | The URL of the image to be classified. |

### Autocomplete Ingredient Search
`GET https://www.apizie.tech/v1/social-media:spoonacular/autocomplete-ingredient-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| metaInformation | boolean | no | Whether to return more meta information about the ingredients. |
| intolerances | string | no | A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the… |
| language | string | no | The language of the input. Either 'en' or 'de'. |

### Compute Glycemic Load
`POST https://www.apizie.tech/v1/social-media:spoonacular/compute-glycemic-load` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| body | object | yes | JSON request body |

### Map Ingredients to Grocery Products
`POST https://www.apizie.tech/v1/social-media:spoonacular/map-ingredients-to-grocery-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Ingredient Search
`GET https://www.apizie.tech/v1/social-media:spoonacular/ingredient-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| addChildren | boolean | no | Whether to add children of found foods. |
| minProteinPercent | number | no | The minimum percentage of protein the food must have (between 0 and 100). |
| maxProteinPercent | number | no | The maximum percentage of protein the food can have (between 0 and 100). |
| minFatPercent | number | no | The minimum percentage of fat the food must have (between 0 and 100). |
| maxFatPercent | number | no | The maximum percentage of fat the food can have (between 0 and 100). |
| minCarbsPercent | number | no | The minimum percentage of carbs the food must have (between 0 and 100). |
| maxCarbsPercent | number | no | The maximum percentage of carbs the food can have (between 0 and 100). |
| metaInformation | boolean | no | Whether to return more meta information about the ingredients. |
| intolerances | string | no | A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the… |
| sort | string | no | The strategy to sort recipes by. See a full list of supported sorting options. |
| sortDirection | string | no | The direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending). |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| language | string | no | The language of the input. Either 'en' or 'de'. |

### Get Ingredient Substitutes
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-ingredient-substitutes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ingredientName | string | yes | The name of the ingredient you want to replace. |

### Compute Ingredient Amount
`GET https://www.apizie.tech/v1/social-media:spoonacular/compute-ingredient-amount` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the ingredient you want the amount for. |
| nutrient | string | yes | The target nutrient. See a list of supported nutrients. |
| target | number | yes | The target number of the given nutrient. |
| unit | string | no | The target unit. |

### Get Ingredient Information
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-ingredient-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The ingredient id. |
| amount | number | no | The amount of this ingredient. |
| unit | string | no | The unit for the given amount. |

### Get Ingredient Substitutes by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-ingredient-substitutes-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the ingredient you want substitutes for. |

### Random Food Joke
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-arandom-food-joke` (byok)

### Search Menu Items
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-menu-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| minCalories | number | no | The minimum amount of calories the menu item must have. |
| maxCalories | number | no | The maximum amount of calories the menu item can have. |
| minCarbs | number | no | The minimum amount of carbohydrates in grams the menu item must have. |
| maxCarbs | number | no | The maximum amount of carbohydrates in grams the menu item can have. |
| minProtein | number | no | The minimum amount of protein in grams the menu item must have. |
| maxProtein | number | no | The maximum amount of protein in grams the menu item can have. |
| minFat | number | no | The minimum amount of fat in grams the menu item must have. |
| maxFat | number | no | The maximum amount of fat in grams the menu item can have. |
| addMenuItemInformation | boolean | no | If set to true, you get more information about the menu items returned. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Autocomplete Menu Item Search
`GET https://www.apizie.tech/v1/social-media:spoonacular/autocomplete-menu-item-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The (partial) search query. |
| number | number | no | The number of results to return (between 1 and 25). |

### Get Menu Item Information
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-menu-item-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The menu item id. |

### Menu Item Nutrition Label Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/menu-item-nutrition-label-widget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The menu item id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Menu Item Nutrition Label Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/menu-item-nutrition-label-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The menu item id. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Menu Item Nutrition by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-menu-item-nutrition-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The menu item id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |

### Menu Item Nutrition by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/menu-item-nutrition-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The menu item id. |

### Classify Grocery Product
`POST https://www.apizie.tech/v1/social-media:spoonacular/classify-grocery-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| locale | string | no | The display name of the returned category, supported is en_US (for American English) and en_GB (for British English). |
| body | object | yes | JSON request body |

### Classify Grocery Product Bulk
`POST https://www.apizie.tech/v1/social-media:spoonacular/classify-grocery-product-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| locale | string | no | The display name of the returned category, supported is en_US (for American English) and en_GB (for British English). |
| body | object | yes | JSON request body |

### Search Grocery Products
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-grocery-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| minCalories | number | no | The minimum amount of calories the product must have. |
| maxCalories | number | no | The maximum amount of calories the product can have. |
| minCarbs | number | no | The minimum amount of carbohydrates in grams the product must have. |
| maxCarbs | number | no | The maximum amount of carbohydrates in grams the product can have. |
| minProtein | number | no | The minimum amount of protein in grams the product must have. |
| maxProtein | number | no | The maximum amount of protein in grams the product can have. |
| minFat | number | no | The minimum amount of fat in grams the product must have. |
| maxFat | number | no | The maximum amount of fat in grams the product can have. |
| addProductInformation | boolean | no | If set to true, you get more information about the products returned. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Autocomplete Product Search
`GET https://www.apizie.tech/v1/social-media:spoonacular/autocomplete-product-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The (partial) search query. |
| number | integer | no | The number of results to return (between 1 and 25). |

### Search Grocery Products by UPC
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-grocery-products-by-upc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| upc | number | yes | The product's UPC. |

### Get Comparable Products
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-comparable-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| upc | number | yes | The UPC of the product for which you want to find comparable products. |

### Get Product Information
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-product-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the packaged food. |

### Product Nutrition Label Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/product-nutrition-label-widget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The product id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Product Nutrition Label Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/product-nutrition-label-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The product id. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Product Nutrition by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-product-nutrition-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the product. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |

### Product Nutrition by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/product-nutrition-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the product. |

### Search Restaurants
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-restaurants` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The search query. |
| lat | number | no | The latitude of the user's location. |
| lng | number | no | The longitude of the user's location.". |
| distance | number | no | The distance around the location in miles. |
| budget | number | no | The user's budget for a meal in USD. |
| cuisine | string | no | The cuisine of the restaurant. |
| min-rating | number | no | The minimum rating of the restaurant between 0 and 5. |
| is-open | boolean | no | Whether the restaurant must be open at the time of search. |
| sort | string | no | How to sort the results, one of the following 'cheapest', 'fastest', 'rating', 'distance' or the default 'relevance'. |
| page | number | no | The page number of results. |

### Search All Food
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-all-food` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Search Site Content
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-site-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The query to search for. You can also use partial queries such as "spagh" to already find spaghetti recipes, articles, grocery products,… |

### Random Food Trivia
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-random-food-trivia` (byok)

### Search Food Videos
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-food-videos` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| type | string | no | The type of the recipes. See a full list of supported meal types. |
| cuisine | string | no | The cuisine(s) of the recipes. One or more, comma separated. See a full list of supported cuisines. |
| diet | string | no | The diet for which the recipes must be suitable. See a full list of supported diets. |
| includeIngredients | string | no | A comma-separated list of ingredients that the recipes should contain. |
| excludeIngredients | string | no | A comma-separated list of ingredients or ingredient types that the recipes must not contain. |
| minLength | number | no | Minimum video length in seconds. |
| maxLength | number | no | Maximum video length in seconds. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Wine Description
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-wine-description` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| wine | string | yes | The name of the wine that should be paired, e.g. "merlot", "riesling", or "malbec". |

### Dish Pairing for Wine
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-dish-pairing-for-wine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| wine | string | yes | The type of wine that should be paired, e.g. "merlot", "riesling", or "malbec". |

### Wine Pairing
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-wine-pairing` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| food | string | yes | The food to get a pairing for. This can be a dish ("steak"), an ingredient ("salmon"), or a cuisine ("italian"). |
| maxPrice | number | no | The maximum price for the specific wine recommendation in USD. |

### Wine Recommendation
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-wine-recommendation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| wine | string | yes | The type of wine to get a specific product recommendation for. |
| maxPrice | number | no | The maximum price for the specific wine recommendation in USD. |
| minRating | number | no | The minimum rating of the recommended wine between 0 and 1. For example, 0.8 equals 4 out of 5 stars. |
| number | number | no | The number of wine recommendations expected (between 1 and 100). |

### Generate Meal Plan
`GET https://www.apizie.tech/v1/social-media:spoonacular/generate-meal-plan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| timeFrame | string | no | Either for one "day" or an entire "week". |
| targetCalories | number | no | What is the caloric target for one day? The meal plan generator will try to get as close as possible to that goal. |
| diet | string | no | Enter a diet that the meal plan has to adhere to. See a full list of supported diets. |
| exclude | string | no | A comma-separated list of allergens or ingredients that must be excluded. |

### Clear Meal Plan Day
`POST https://www.apizie.tech/v1/social-media:spoonacular/clear-meal-plan-day` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| date | string | yes | The date in the format yyyy-mm-dd. |
| hash | string | yes | The private hash for the username. |

### Add to Meal Plan
`POST https://www.apizie.tech/v1/social-media:spoonacular/add-to-meal-plan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |

### Delete from Meal Plan
`POST https://www.apizie.tech/v1/social-media:spoonacular/delete-from-meal-plan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| id | number | yes | The shopping list item id. |
| hash | string | yes | The private hash for the username. |

### Get Shopping List
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-shopping-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |

### Add to Shopping List
`POST https://www.apizie.tech/v1/social-media:spoonacular/add-to-shopping-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |

### Delete from Shopping List
`POST https://www.apizie.tech/v1/social-media:spoonacular/delete-from-shopping-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| id | number | yes | The shopping list item id. |
| hash | string | yes | The private hash for the username. |

### Generate Shopping List
`POST https://www.apizie.tech/v1/social-media:spoonacular/generate-shopping-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| start-date | string | yes | The start date in the format yyyy-mm-dd. |
| end-date | string | yes | The end date in the format yyyy-mm-dd. |
| hash | string | yes | The private hash for the username. |

### Get Meal Plan Templates
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-meal-plan-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |

### Add Meal Plan Template
`POST https://www.apizie.tech/v1/social-media:spoonacular/add-meal-plan-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| hash | string | yes | The private hash for the username. |

### Get Meal Plan Template
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-meal-plan-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| id | number | yes | The shopping list item id. |
| hash | string | yes | The private hash for the username. |

### Delete Meal Plan Template
`POST https://www.apizie.tech/v1/social-media:spoonacular/delete-meal-plan-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| id | number | yes | The shopping list item id. |
| hash | string | yes | The private hash for the username. |

### Get Meal Plan Week
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-meal-plan-week` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | The username. |
| start-date | string | yes | The start date of the meal planned week in the format yyyy-mm-dd. |
| hash | string | yes | The private hash for the username. |

### Analyze Recipe
`POST https://www.apizie.tech/v1/social-media:spoonacular/analyze-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The input language, either "en" or "de". |
| includeNutrition | boolean | no | Whether nutrition data should be added to correctly parsed ingredients. |
| includeTaste | boolean | no | Whether taste data should be added to correctly parsed ingredients. |

### Analyze Recipe Instructions
`POST https://www.apizie.tech/v1/social-media:spoonacular/analyze-recipe-instructions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Autocomplete Recipe Search
`GET https://www.apizie.tech/v1/social-media:spoonacular/autocomplete-recipe-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Search Recipes
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The (natural language) search query. |
| cuisine | string | no | The cuisine(s) of the recipes. One or more, comma separated (will be interpreted as 'OR'). See a full list of supported cuisines. |
| excludeCuisine | string | no | The cuisine(s) the recipes must not match. One or more, comma separated (will be interpreted as 'AND'). See a full list of supported… |
| diet | string | no | The diet for which the recipes must be suitable. See a full list of supported diets. |
| intolerances | string | no | A comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the… |
| equipment | string | no | The equipment required. Multiple values will be interpreted as 'or'. For example, value could be "blender, frying pan, bowl". |
| includeIngredients | string | no | A comma-separated list of ingredients that should/must be used in the recipes. |
| excludeIngredients | string | no | A comma-separated list of ingredients or ingredient types that the recipes must not contain. |
| type | string | no | The type of recipe. See a full list of supported meal types. |
| instructionsRequired | boolean | no | Whether the recipes must have instructions. |
| fillIngredients | boolean | no | Add information about the ingredients and whether they are used or missing in relation to the query. |
| addRecipeInformation | boolean | no | If set to true, you get more information about the recipes returned. |
| addRecipeNutrition | boolean | no | If set to true, you get nutritional information about each recipes returned. |
| author | string | no | The username of the recipe author. |
| tags | string | no | The tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have. |
| recipeBoxId | number | no | The id of the recipe box to which the search should be limited to. |
| titleMatch | string | no | Enter text that must be found in the title of the recipes. |
| maxReadyTime | number | no | The maximum time in minutes it should take to prepare and cook the recipe. |
| ignorePantry | boolean | no | Whether to ignore typical pantry items, such as water, salt, flour, etc. |
| sort | string | no | The strategy to sort recipes by. See a full list of supported sorting options. |
| sortDirection | string | no | The direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending). |
| minCarbs | number | no | The minimum amount of carbohydrates in grams the recipe must have. |
| maxCarbs | number | no | The maximum amount of carbohydrates in grams the recipe can have. |
| minProtein | number | no | The minimum amount of protein in grams the recipe must have. |
| maxProtein | number | no | The maximum amount of protein in grams the recipe can have. |
| minCalories | number | no | The minimum amount of calories the recipe must have. |
| maxCalories | number | no | The maximum amount of calories the recipe can have. |
| minFat | number | no | The minimum amount of fat in grams the recipe must have. |
| maxFat | number | no | The maximum amount of fat in grams the recipe can have. |
| minAlcohol | number | no | The minimum amount of alcohol in grams the recipe must have. |
| maxAlcohol | number | no | The maximum amount of alcohol in grams the recipe can have. |
| minCaffeine | number | no | The minimum amount of caffeine in milligrams the recipe must have. |
| maxCaffeine | number | no | The maximum amount of caffeine in milligrams the recipe can have. |
| minCopper | number | no | The minimum amount of copper in milligrams the recipe must have. |
| maxCopper | number | no | The maximum amount of copper in milligrams the recipe can have. |
| minCalcium | number | no | The minimum amount of calcium in milligrams the recipe must have. |
| maxCalcium | number | no | The maximum amount of calcium in milligrams the recipe can have. |
| minCholine | number | no | The minimum amount of choline in milligrams the recipe must have. |
| maxCholine | number | no | The maximum amount of choline in milligrams the recipe can have. |
| minCholesterol | number | no | The minimum amount of cholesterol in milligrams the recipe must have. |
| maxCholesterol | number | no | The maximum amount of cholesterol in milligrams the recipe can have. |
| minFluoride | number | no | The minimum amount of fluoride in milligrams the recipe must have. |
| maxFluoride | number | no | The maximum amount of fluoride in milligrams the recipe can have. |
| minSaturatedFat | number | no | The minimum amount of saturated fat in grams the recipe must have. |
| maxSaturatedFat | number | no | The maximum amount of saturated fat in grams the recipe can have. |
| minVitaminA | number | no | The minimum amount of Vitamin A in IU the recipe must have. |
| maxVitaminA | number | no | The maximum amount of Vitamin A in IU the recipe can have. |
| minVitaminC | number | no | The minimum amount of Vitamin C milligrams the recipe must have. |
| maxVitaminC | number | no | The maximum amount of Vitamin C in milligrams the recipe can have. |
| minVitaminD | number | no | The minimum amount of Vitamin D in micrograms the recipe must have. |
| maxVitaminD | number | no | The maximum amount of Vitamin D in micrograms the recipe can have. |
| minVitaminE | number | no | The minimum amount of Vitamin E in milligrams the recipe must have. |
| maxVitaminE | number | no | The maximum amount of Vitamin E in milligrams the recipe can have. |
| minVitaminK | number | no | The minimum amount of Vitamin K in micrograms the recipe must have. |
| maxVitaminK | number | no | The maximum amount of Vitamin K in micrograms the recipe can have. |
| minVitaminB1 | number | no | The minimum amount of Vitamin B1 in milligrams the recipe must have. |
| maxVitaminB1 | number | no | The maximum amount of Vitamin B1 in milligrams the recipe can have. |
| minVitaminB2 | number | no | The minimum amount of Vitamin B2 in milligrams the recipe must have. |
| maxVitaminB2 | number | no | The maximum amount of Vitamin B2 in milligrams the recipe can have. |
| minVitaminB5 | number | no | The minimum amount of Vitamin B5 in milligrams the recipe must have. |
| maxVitaminB5 | number | no | The maximum amount of Vitamin B5 in milligrams the recipe can have. |
| minVitaminB3 | number | no | The minimum amount of Vitamin B3 in milligrams the recipe must have. |
| maxVitaminB3 | number | no | The maximum amount of Vitamin B3 in milligrams the recipe can have. |
| minVitaminB6 | number | no | The minimum amount of Vitamin B6 in milligrams the recipe must have. |
| maxVitaminB6 | number | no | The maximum amount of Vitamin B6 in milligrams the recipe can have. |
| minVitaminB12 | number | no | The minimum amount of Vitamin B12 in micrograms the recipe must have. |
| maxVitaminB12 | number | no | The maximum amount of Vitamin B12 in micrograms the recipe can have. |
| minFiber | number | no | The minimum amount of fiber in grams the recipe must have. |
| maxFiber | number | no | The maximum amount of fiber in grams the recipe can have. |
| minFolate | number | no | The minimum amount of folate in micrograms the recipe must have. |
| maxFolate | number | no | The maximum amount of folate in micrograms the recipe can have. |
| minFolicAcid | number | no | The minimum amount of folic acid in micrograms the recipe must have. |
| maxFolicAcid | number | no | The maximum amount of folic acid in micrograms the recipe can have. |
| minIodine | number | no | The minimum amount of iodine in micrograms the recipe must have. |
| maxIodine | number | no | The maximum amount of iodine in micrograms the recipe can have. |
| minIron | number | no | The minimum amount of iron in milligrams the recipe must have. |
| maxIron | number | no | The maximum amount of iron in milligrams the recipe can have. |
| minMagnesium | number | no | The minimum amount of magnesium in milligrams the recipe must have. |
| maxMagnesium | number | no | The maximum amount of magnesium in milligrams the recipe can have. |
| minManganese | number | no | The minimum amount of manganese in milligrams the recipe must have. |
| maxManganese | number | no | The maximum amount of manganese in milligrams the recipe can have. |
| minPhosphorus | number | no | The minimum amount of phosphorus in milligrams the recipe must have. |
| maxPhosphorus | number | no | The maximum amount of phosphorus in milligrams the recipe can have. |
| minPotassium | number | no | The minimum amount of potassium in milligrams the recipe must have. |
| maxPotassium | number | no | The maximum amount of potassium in milligrams the recipe can have. |
| minSelenium | number | no | The minimum amount of selenium in micrograms the recipe must have. |
| maxSelenium | number | no | The maximum amount of selenium in micrograms the recipe can have. |
| minSodium | number | no | The minimum amount of sodium in milligrams the recipe must have. |
| maxSodium | number | no | The maximum amount of sodium in milligrams the recipe can have. |
| minSugar | number | no | The minimum amount of sugar in grams the recipe must have. |
| maxSugar | number | no | The maximum amount of sugar in grams the recipe can have. |
| minZinc | number | no | The minimum amount of zinc in milligrams the recipe must have. |
| maxZinc | number | no | The maximum amount of zinc in milligrams the recipe can have. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| limitLicense | boolean | no | Whether the recipes should have an open license that allows display with proper attribution. |

### Convert Amounts
`GET https://www.apizie.tech/v1/social-media:spoonacular/convert-amounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ingredientName | string | yes | The ingredient which you want to convert. |
| sourceAmount | number | yes | The amount from which you want to convert, e.g. the 2.5 in "2.5 cups of flour to grams". |
| sourceUnit | string | yes | The unit from which you want to convert, e.g. the grams in "2.5 cups of flour to grams". You can also use "piece", e.g. "3.4 oz tomatoes… |
| targetUnit | string | yes | The unit to which you want to convert, e.g. the grams in "2.5 cups of flour to grams". You can also use "piece", e.g. "3.4 oz tomatoes to… |

### Classify Cuisine
`POST https://www.apizie.tech/v1/social-media:spoonacular/classify-cuisine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Extract Recipe from Website
`GET https://www.apizie.tech/v1/social-media:spoonacular/extract-recipe-from-website` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The URL of the recipe page. |
| forceExtraction | boolean | no | If true, the extraction will be triggered whether we already know the recipe or not. Use this only if information is missing as this… |
| analyze | boolean | no | If true, the recipe will be analyzed and classified resolving in more data such as cuisines, dish types, and more. |
| includeNutrition | boolean | no | Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe,… |
| includeTaste | boolean | no | Whether taste data should be added to correctly parsed ingredients. |

### Search Recipes by Ingredients
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-recipes-by-ingredients` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ingredients | string | no | A comma-separated list of ingredients that the recipes should contain. |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| limitLicense | boolean | no | Whether the recipes should have an open license that allows display with proper attribution. |
| ranking | number | no | Whether to maximize used ingredients (1) or minimize missing ingredients (2) first. |
| ignorePantry | boolean | no | Whether to ignore typical pantry items, such as water, salt, flour, etc. |

### Search Recipes by Nutrients
`GET https://www.apizie.tech/v1/social-media:spoonacular/search-recipes-by-nutrients` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| minCarbs | number | no | The minimum amount of carbohydrates in grams the recipe must have. |
| maxCarbs | number | no | The maximum amount of carbohydrates in grams the recipe can have. |
| minProtein | number | no | The minimum amount of protein in grams the recipe must have. |
| maxProtein | number | no | The maximum amount of protein in grams the recipe can have. |
| minCalories | number | no | The minimum amount of calories the recipe must have. |
| maxCalories | number | no | The maximum amount of calories the recipe can have. |
| minFat | number | no | The minimum amount of fat in grams the recipe must have. |
| maxFat | number | no | The maximum amount of fat in grams the recipe can have. |
| minAlcohol | number | no | The minimum amount of alcohol in grams the recipe must have. |
| maxAlcohol | number | no | The maximum amount of alcohol in grams the recipe can have. |
| minCaffeine | number | no | The minimum amount of caffeine in milligrams the recipe must have. |
| maxCaffeine | number | no | The maximum amount of caffeine in milligrams the recipe can have. |
| minCopper | number | no | The minimum amount of copper in milligrams the recipe must have. |
| maxCopper | number | no | The maximum amount of copper in milligrams the recipe can have. |
| minCalcium | number | no | The minimum amount of calcium in milligrams the recipe must have. |
| maxCalcium | number | no | The maximum amount of calcium in milligrams the recipe can have. |
| minCholine | number | no | The minimum amount of choline in milligrams the recipe must have. |
| maxCholine | number | no | The maximum amount of choline in milligrams the recipe can have. |
| minCholesterol | number | no | The minimum amount of cholesterol in milligrams the recipe must have. |
| maxCholesterol | number | no | The maximum amount of cholesterol in milligrams the recipe can have. |
| minFluoride | number | no | The minimum amount of fluoride in milligrams the recipe must have. |
| maxFluoride | number | no | The maximum amount of fluoride in milligrams the recipe can have. |
| minSaturatedFat | number | no | The minimum amount of saturated fat in grams the recipe must have. |
| maxSaturatedFat | number | no | The maximum amount of saturated fat in grams the recipe can have. |
| minVitaminA | number | no | The minimum amount of Vitamin A in IU the recipe must have. |
| maxVitaminA | number | no | The maximum amount of Vitamin A in IU the recipe can have. |
| minVitaminC | number | no | The minimum amount of Vitamin C in milligrams the recipe must have. |
| maxVitaminC | number | no | The maximum amount of Vitamin C in milligrams the recipe can have. |
| minVitaminD | number | no | The minimum amount of Vitamin D in micrograms the recipe must have. |
| maxVitaminD | number | no | The maximum amount of Vitamin D in micrograms the recipe can have. |
| minVitaminE | number | no | The minimum amount of Vitamin E in milligrams the recipe must have. |
| maxVitaminE | number | no | The maximum amount of Vitamin E in milligrams the recipe can have. |
| minVitaminK | number | no | The minimum amount of Vitamin K in micrograms the recipe must have. |
| maxVitaminK | number | no | The maximum amount of Vitamin K in micrograms the recipe can have. |
| minVitaminB1 | number | no | The minimum amount of Vitamin B1 in milligrams the recipe must have. |
| maxVitaminB1 | number | no | The maximum amount of Vitamin B1 in milligrams the recipe can have. |
| minVitaminB2 | number | no | The minimum amount of Vitamin B2 in milligrams the recipe must have. |
| maxVitaminB2 | number | no | The maximum amount of Vitamin B2 in milligrams the recipe can have. |
| minVitaminB5 | number | no | The minimum amount of Vitamin B5 in milligrams the recipe must have. |
| maxVitaminB5 | number | no | The maximum amount of Vitamin B5 in milligrams the recipe can have. |
| minVitaminB3 | number | no | The minimum amount of Vitamin B3 in milligrams the recipe must have. |
| maxVitaminB3 | number | no | The maximum amount of Vitamin B3 in milligrams the recipe can have. |
| minVitaminB6 | number | no | The minimum amount of Vitamin B6 in milligrams the recipe must have. |
| maxVitaminB6 | number | no | The maximum amount of Vitamin B6 in milligrams the recipe can have. |
| minVitaminB12 | number | no | The minimum amount of Vitamin B12 in micrograms the recipe must have. |
| maxVitaminB12 | number | no | The maximum amount of Vitamin B12 in micrograms the recipe can have. |
| minFiber | number | no | The minimum amount of fiber in grams the recipe must have. |
| maxFiber | number | no | The maximum amount of fiber in grams the recipe can have. |
| minFolate | number | no | The minimum amount of folate in micrograms the recipe must have. |
| maxFolate | number | no | The maximum amount of folate in micrograms the recipe can have. |
| minFolicAcid | number | no | The minimum amount of folic acid in micrograms the recipe must have. |
| maxFolicAcid | number | no | The maximum amount of folic acid in micrograms the recipe can have. |
| minIodine | number | no | The minimum amount of iodine in micrograms the recipe must have. |
| maxIodine | number | no | The maximum amount of iodine in micrograms the recipe can have. |
| minIron | number | no | The minimum amount of iron in milligrams the recipe must have. |
| maxIron | number | no | The maximum amount of iron in milligrams the recipe can have. |
| minMagnesium | number | no | The minimum amount of magnesium in milligrams the recipe must have. |
| maxMagnesium | number | no | The maximum amount of magnesium in milligrams the recipe can have. |
| minManganese | number | no | The minimum amount of manganese in milligrams the recipe must have. |
| maxManganese | number | no | The maximum amount of manganese in milligrams the recipe can have. |
| minPhosphorus | number | no | The minimum amount of phosphorus in milligrams the recipe must have. |
| maxPhosphorus | number | no | The maximum amount of phosphorus in milligrams the recipe can have. |
| minPotassium | number | no | The minimum amount of potassium in milligrams the recipe must have. |
| maxPotassium | number | no | The maximum amount of potassium in milligrams the recipe can have. |
| minSelenium | number | no | The minimum amount of selenium in micrograms the recipe must have. |
| maxSelenium | number | no | The maximum amount of selenium in micrograms the recipe can have. |
| minSodium | number | no | The minimum amount of sodium in milligrams the recipe must have. |
| maxSodium | number | no | The maximum amount of sodium in milligrams the recipe can have. |
| minSugar | number | no | The minimum amount of sugar in grams the recipe must have. |
| maxSugar | number | no | The maximum amount of sugar in grams the recipe can have. |
| minZinc | number | no | The minimum amount of zinc in milligrams the recipe must have. |
| maxZinc | number | no | The maximum amount of zinc in milligrams the recipe can have. |
| offset | integer | no | The number of results to skip (between 0 and 900). |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| random | boolean | no | If true, every request will give you a random set of recipes within the requested limits. |
| limitLicense | boolean | no | Whether the recipes should have an open license that allows display with proper attribution. |

### Guess Nutrition by Dish Name
`GET https://www.apizie.tech/v1/social-media:spoonacular/guess-nutrition-by-dish-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | yes | The title of the dish. |

### Get Recipe Information Bulk
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-information-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ids | string | yes | A comma-separated list of recipe ids. |
| includeNutrition | boolean | no | Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe,… |

### Parse Ingredients
`POST https://www.apizie.tech/v1/social-media:spoonacular/parse-ingredients` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| body | object | yes | Form fields as a JSON object |

### Analyze a Recipe Search Query
`GET https://www.apizie.tech/v1/social-media:spoonacular/analyze-arecipe-search-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes | The recipe search query. |

### Quick Answer
`GET https://www.apizie.tech/v1/social-media:spoonacular/quick-answer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes | The nutrition related question. |

### Get Random Recipes
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-random-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limitLicense | boolean | no | Whether the recipes should have an open license that allows display with proper attribution. |
| tags | string | no | The tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have. |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |

### Equipment Widget
`POST https://www.apizie.tech/v1/social-media:spoonacular/visualize-equipment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Ingredients Widget
`POST https://www.apizie.tech/v1/social-media:spoonacular/visualize-ingredients` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| body | object | yes | Form fields as a JSON object |

### Recipe Nutrition Widget
`POST https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-nutrition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| body | object | yes | Form fields as a JSON object |

### Price Breakdown Widget
`POST https://www.apizie.tech/v1/social-media:spoonacular/visualize-price-breakdown` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| body | object | yes | Form fields as a JSON object |

### Create Recipe Card
`POST https://www.apizie.tech/v1/social-media:spoonacular/create-recipe-card` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Recipe Taste Widget
`POST https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-taste` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | The language of the input. Either 'en' or 'de'. |
| normalize | boolean | no | Whether to normalize to the strongest taste. |
| rgb | string | no | Red, green, blue values for the chart color. |
| body | object | yes | Form fields as a JSON object |

### Get Analyzed Recipe Instructions
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-analyzed-recipe-instructions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| stepBreakdown | boolean | no | Whether to break down the recipe steps even more. |

### Create Recipe Card
`GET https://www.apizie.tech/v1/social-media:spoonacular/create-recipe-card-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| mask | string | no | The mask to put over the recipe image ("ellipseMask", "diamondMask", "starMask", "heartMask", "potMask", "fishMask"). |
| backgroundImage | string | no | The background image ("none","background1", or "background2"). |
| backgroundColor | string | no | The background color for the recipe card as a hex-string. |
| fontColor | string | no | The font color for the recipe card as a hex-string. |

### Equipment by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-equipment-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |

### Equipment by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-equipment-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Equipment by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/equipment-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Get Recipe Information
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the recipe. |
| includeNutrition | boolean | no | Include nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe,… |

### Ingredients by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-ingredients-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |
| measure | string | no | Whether the the measures should be 'us' or 'metric'. |

### Ingredients by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-ingredients-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Ingredients by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/ingredients-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| measure | string | no | Whether the the measures should be 'us' or 'metric'. |

### Recipe Nutrition Label Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/recipe-nutrition-label-widget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Recipe Nutrition Label Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/recipe-nutrition-label-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| showOptionalNutrients | boolean | no | Whether to show optional nutrients. |
| showZeroValues | boolean | no | Whether to show zero values. |
| showIngredients | boolean | no | Whether to show a list of ingredients. |

### Recipe Nutrition by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-nutrition-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |

### Nutrition by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-nutrition-widget-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Recipe Nutrition by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/recipe-nutrition-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Price Breakdown by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-price-breakdown-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| defaultCss | boolean | no | Whether the default CSS should be added to the response. |

### Price Breakdown by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-price-breakdown-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Price Breakdown by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/price-breakdown-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Get Similar Recipes
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-similar-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The id of the source recipe for which similar recipes should be found. |
| number | integer | no | The maximum number of items to return (between 1 and 100). Defaults to 10. |
| limitLicense | boolean | no | Whether the recipes should have an open license that allows display with proper attribution. |

### Summarize Recipe
`GET https://www.apizie.tech/v1/social-media:spoonacular/summarize-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |

### Recipe Taste by ID Widget
`GET https://www.apizie.tech/v1/social-media:spoonacular/visualize-recipe-taste-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| normalize | boolean | no | Whether to normalize to the strongest taste. |
| rgb | string | no | Red, green, blue values for the chart color. |

### Taste by ID
`GET https://www.apizie.tech/v1/social-media:spoonacular/get-recipe-taste-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| normalize | boolean | no | Normalize to the strongest taste. |

### Recipe Taste by ID Image
`GET https://www.apizie.tech/v1/social-media:spoonacular/recipe-taste-by-idimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | yes | The recipe id. |
| normalize | boolean | no | Normalize to the strongest taste. |
| rgb | string | no | Red, green, blue values for the chart color. |

### Connect User
`POST https://www.apizie.tech/v1/social-media:spoonacular/connect-user` (byok)

## Example
```
curl "https://www.apizie.tech/v1/social-media:spoonacular/talk-to-chatbot" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the spoonacular API API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/social-media:spoonacular/talk-to-chatbot with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the spoonacular API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. spoonacular API itself also needs your own key from spoonacular.com.

### Can AI agents use the spoonacular API API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key social-media:spoonacular.

### What is the status of the spoonacular API API?
Needs your own provider key (bring your own key)