Spoonacular Wine API

openapi: 3.2.0
info:
  title: spoonacular 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.
  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