openapi: 3.0.0
info:
title: spoonacular Ingredients Wine API
description: '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 recipe search engine makes it possible to search for recipes using natural language queries, such as "gluten free brownies without sugar" or "low fat vegan cupcakes." You can automatically calculate the nutritional information for any recipe, analyze recipe costs, visualize ingredient lists, find recipes for what''s in your fridge, find recipes based on special diets, nutritional requirements, or favorite ingredients, classify recipes into types and cuisines, convert ingredient amounts, or even compute an entire meal plan. With our powerful API, you can create many kinds of food and especially nutrition apps.
Special diets/dietary requirements currently available include: vegan, vegetarian, pescetarian, gluten free, grain free, dairy free, high protein, whole 30, low sodium, low carb, Paleo, ketogenic, FODMAP, and Primal.'
contact:
name: David Urbansky
email: mail@spoonacular.com
url: https://spoonacular.com/contact
version: 2.0.2
x-codegen-settings:
Nullify404: false
GenerateAsyncCode: true
UseMethodPrefix: true
UseModelPostfix: false
UseControllerPrefix: true
UseEnumPostfix: true
CollectParameters: false
UseConstructorsForConfig: true
UseCommonSDKLibrary: false
iOSUseAppInfoPlist: true
AndroidUseAppManifest: true
BodySerialization: 0
EnableAdditionalModelProperties: false
PreserveParameterOrder: false
AppendContentHeaders: true
iOSGenerateCoreData: false
GenerateInterfaces: false
NodeHttpClient: NODE_REQUEST
ValidateRequiredParameters: false
JavaUsePropertiesConfig: false
Timeout: 0
StoreTimezoneInformation: false
EnablePHPComposerVersionString: false
EnableLogging: false
ArraySerialization: Indexed
ModelSerializationScheme: Json
UseExceptionPrefix: true
RunscopeEnabled: false
JavaHttpClient: JAVA_OK
ParameterArrayFormat: ParamArrayWithIndex
SecurityProtocols:
- Ssl3
- Tls
GenerateTravisConfig: false
GenerateCircleConfig: false
GenerateAppveyorConfig: false
GenerateJenkinsConfig: false
EnableHttpCache: false
Retries: 0
RetryInterval: 1
GenerateAdvancedDocs: false
UnderscoreNumbers: true
UseSingletonPattern: true
DisableLinting: false
ApplyCustomizations: []
SortResources: false
AllowSkippingSSLCertVerification: false
DoNotSplitWords: []
EnableGlobalUserAgent: true
ReturnCompleteHttpResponse: false
GenerateModels: true
GenerateExceptions: true
IgnoreIfNullJson: false
DisableDocs: false
LiftParameterDescriptionFromCustomType: false
ThrowForHttpErrorStatusCodes: true
ResponseMapping:
Type: Simple
ForceKeywordArgsInRuby: false
SymbolizeHashKeysInRuby: false
x-server-configuration:
default-environment: production
default-server: default
environments:
- name: production
servers:
- name: default
url: https://api.spoonacular.com
parameters: []
license:
name: spoonacular API Terms
url: https://spoonacular.com/food-api/terms
termsOfService: https://spoonacular.com/food-api/terms
x-apis-json-aid: spoonacular
x-spec-source: https://github.com/ddsky/spoonacular-api-clients/blob/master/spoonacular-openapi-3.json
x-last-validated: '2026-06-03'
x-providerName: spoonacular.com
servers:
- url: https://api.spoonacular.com
variables: {}
security:
- apiKeyScheme: []
tags:
- name: Wine
paths:
/food/wine/dishes:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
description: ''
type: object
properties:
pairings:
type: array
items:
type: string
text:
type: string
minLength: 1
required:
- pairings
- text
examples:
example-1:
value:
pairings:
- stew
- steak
- chili
- burger
text: Malbec is a dry red wine which is bold and full bodied. It goes especially well with round steak, tri tip steak, steak, boneless pork chops, and pizza burger.
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
parameters:
- name: wine
description: The type of wine that should be paired, e.g. "merlot", "riesling", or "malbec".
schema:
type: string
example: malbec
required: true
style: form
explode: false
in: query
example: malbec
externalDocs:
description: Read entire docs
url: https://spoonacular.com/food-api/docs#Dish-Pairing-for-Wine
summary: Dish Pairing for Wine
description: Find a dish that goes well with a given wine.
operationId: getDishPairingForWine
deprecated: false
tags:
- Wine
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/food/wine/pairing:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
description: ''
type: object
properties:
pairedWines:
type: array
items:
type: string
pairingText:
type: string
minLength: 1
productMatches:
type: array
uniqueItems: true
minItems: 0
items:
type: object
properties:
id:
type: integer
title:
type: string
minLength: 1
averageRating:
type: number
description:
type: string
imageUrl:
type: string
minLength: 1
link:
type: string
minLength: 1
price:
type: string
minLength: 1
ratingCount:
type: integer
score:
type: number
required:
- id
- title
- averageRating
- imageUrl
- link
- price
- ratingCount
- score
required:
- pairedWines
- pairingText
- productMatches
examples:
example-1:
value:
pairedWines:
- merlot
- cabernet sauvignon
- pinot noir
pairingText: Merlot, Cabernet Sauvignon, and Pinot Noir are my top picks for Steak. After all, beef and red wine are a classic combination. Generally, leaner steaks go well with light or medium-bodied reds, such as pinot noir or merlot, while fattier steaks can handle a bold red, such as cabernet sauvingnon. The Sterling Vineyards Merlot with a 5 out of 5 star rating seems like a good match. It costs about 29 dollars per bottle.
productMatches:
- id: 428278
title: Sterling Vineyards Merlot
averageRating: 1
description: null
imageUrl: https://spoonacular.com/productImages/428278-312x231.jpg
link: https://www.amazon.com/2014-Sterling-Vineyards-Valley-Merlot/dp/B071FP8NPG?tag=spoonacular-20
price: $28.99
ratingCount: 1
score: 0.75
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
parameters:
- name: food
description: The food to get a pairing for. This can be a dish ("steak"), an ingredient ("salmon"), or a cuisine ("italian").
schema:
type: string
example: steak
required: true
style: form
explode: false
in: query
example: steak
- name: maxPrice
description: The maximum price for the specific wine recommendation in USD.
schema:
type: number
example: 50
required: false
style: form
explode: false
in: query
example: 50
externalDocs:
description: Read entire docs
url: https://spoonacular.com/food-api/docs#Wine-Pairing
summary: Wine Pairing
description: Find a wine that goes well with a food. Food can be a dish name ("steak"), an ingredient name ("salmon"), or a cuisine ("italian").
operationId: getWinePairing
deprecated: false
tags:
- Wine
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/food/wine/description:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
description: ''
type: object
properties:
wineDescription:
type: string
minLength: 1
required:
- wineDescription
examples:
example-1:
value:
wineDescription: Merlot is a dry red wine which is smooth and medium bodied.
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
parameters:
- name: wine
description: The name of the wine that should be paired, e.g. "merlot", "riesling", or "malbec".
schema:
type: string
example: merlot
required: true
style: form
explode: false
in: query
example: merlot
externalDocs:
description: Read entire docs
url: https://spoonacular.com/food-api/docs#Wine-Description
summary: Wine Description
description: Get a simple description of a certain wine, e.g. "malbec", "riesling", or "merlot".
operationId: getWineDescription
deprecated: false
tags:
- Wine
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/food/wine/recommendation:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
description: ''
type: object
properties:
recommendedWines:
type: array
uniqueItems: true
minItems: 0
items:
type: object
properties:
id:
type: integer
title:
type: string
minLength: 1
averageRating:
type: number
description:
type: string
minLength: 1
imageUrl:
type: string
minLength: 1
link:
type: string
minLength: 1
price:
type: string
minLength: 1
ratingCount:
type: integer
score:
type: number
required:
- id
- title
- averageRating
- description
- imageUrl
- link
- price
- ratingCount
- score
totalFound:
type: integer
required:
- recommendedWines
- totalFound
examples:
example-1:
value:
recommendedWines:
- id: 447938
title: Rombauer Merlot
averageRating: 0.96
description: Enticing and lively red color; beautifully aromatic with black cherry and ripe plum. On the palate a purity of blackcurrant, cedar and mint flavors blend together seamlessly. Soft and supple, this wine has a medium-bodied mouth-feel with plush tannins that integrate with the generous finish.Our favorite pairings for this wine include chicken parmesan, cedar-planked salmon over wild rice, and mushroom pizza.
imageUrl: https://spoonacular.com/productImages/447938-312x231.jpg
link: https://click.linksynergy.com/deeplink?id=*QCiIS6t4gA&mid=2025&murl=https%3A%2F%2Fwww.wine.com%2Fproduct%2Frombauer-merlot-2008%2F116883
price: $25.59
ratingCount: 5
score: 0.8975
- id: 430475
title: NV The Big Kahuna Merlot
averageRating: 0.9
description: A ripe and rounded Merlot with notes of plum, blackberry, and hint of spice.
imageUrl: https://spoonacular.com/productImages/430475-312x231.jpg
link: https://www.amazon.com/Big-Kahuna-Merlot-Red-Wine/dp/B01F5XPTUW?tag=spoonacular-20
price: $6.99
ratingCount: 4
score: 0.823076923076923
totalFound: 21
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
parameters:
- name: wine
description: The type of wine to get a specific product recommendation for.
schema:
type: string
example: merlot
required: true
style: form
explode: false
in: query
example: merlot
- name: maxPrice
description: The maximum price for the specific wine recommendation in USD.
schema:
type: number
example: 50
required: false
style: form
explode: false
in: query
example: 50
- name: minRating
description: The minimum rating of the recommended wine between 0 and 1. For example, 0.8 equals 4 out of 5 stars.
schema:
type: number
example: 0.7
required: false
style: form
explode: false
in: query
example: 0.7
- name: number
description: The number of wine recommendations expected (between 1 and 100).
schema:
type: number
example: 3
minimum: 1
maximum: 100
default: 10
required: false
style: form
explode: false
in: query
example: 3
externalDocs:
description: Read entire docs
url: https://spoonacular.com/food-api/docs#Wine-Recommendation
summary: Wine Recommendation
description: Get a specific wine recommendation (concrete product) for a given wine type, e.g. "merlot".
operationId: getWineRecommendation
deprecated: false
tags:
- Wine
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
securitySchemes:
apiKeyScheme:
type: apiKey
name: x-api-key
in: header
externalDocs:
description: The official documentation.
url: https://spoonacular.com/food-api/docs