---
title: "Wine Pairing & Recommendations API"
slug: wine-pairing-recommendations-api
url: https://apyhub.com/skycraft/service/wine-pairing-recommendations-api
provider: Skycraft
categories: [E-commerce Quick Tools, Smart Generation]
tags: [wine-pairing, food-pairing, wine-recommendations, sommelier, menu-planning]
auth: api_key
version: 2.0.2
service_type: sync
endpoints: 4
atoms: 20
mcp: true
---

# Wine Pairing & Recommendations API

Get dish-to-wine pairings, wine-to-dish matches, descriptions, and ranked wine recommendations with price and rating filters.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/dishes` | What it does Returns dish pairing suggestions for a wine. You provide the wine query parameter, and… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/recommendation` | What it does Returns wine recommendations for a given wine query, with optional filters for result… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/pairing` | What it does Returns wine pairing suggestions for a food item. You provide the food to pair, and th… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/description` | What it does Returns a textual description for the wine specified in the wine query parameter. Quer… | 20 |

## Endpoint reference

### Dish Pairing for Wine

`GET https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/dishes` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `wine` | query | string | yes | Example: `malbec`. |

#### Quickstart

Fetch wine dish pairings for a wine query.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/dishes?wine=malbec" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with required `pairings` and `text` fields. `pairings` is an array of strings, and `text` is a non-empty string.

```json
{
  "pairings": ["grilled steak", "mushroom risotto"],
  "text": "Best paired with rich, savory dishes."
}
```

### Wine Recommendation

`GET https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/recommendation` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `wine` | query | string | yes | Example: `merlot`. |
| `number` | query | number | no | Default: `10`. Example: `3`. |
| `maxPrice` | query | number | no | Example: `50`. |
| `minRating` | query | number | no | Example: `0.7`. |

#### Quickstart

Find wine recommendations for a wine name by passing it as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/recommendation?wine=merlot" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `recommendedWines` array and a `totalFound` integer. Each item in `recommendedWines` is an object with `id`, `title`, `averageRating`, `description`, `imageUrl`, `link`, `price`, `ratingCount`, and `score`.

```json
{
  "totalFound": 1,
  "recommendedWines": [
    {
      "id": 123,
      "title": "Merlot Reserve",
      "averageRating": 4.6,
      "description": "A smooth red wine with cherry and plum notes.",
      "imageUrl": "https://example.com/wine.jpg",
      "link": "https://example.com/wine/123",
      "price": "$24.99",
      "ratingCount": 128,
      "score": 0.91
    }
  ]
}
```

### Wine Pairing

`GET https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/pairing` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `food` | query | string | yes | Example: `steak`. |
| `maxPrice` | query | number | no | Example: `50`. |

#### Quickstart

Get a wine pairing recommendation for a food item using the required `food` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/pairing?food=steak" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `pairedWines` (an array of strings), `pairingText` (a string), and `productMatches` (an array of objects). Each product match includes `id`, `title`, `averageRating`, `imageUrl`, `link`, `price`, `ratingCount`, and `score`.

```json
{
  "pairedWines": ["cabernet sauvignon", "merlot"],
  "pairingText": "Rich red wines pair well with steak.",
  "productMatches": [
    {
      "id": 12345,
      "title": "Cabernet Sauvignon",
      "averageRating": 4.7,
      "imageUrl": "https://example.com/wine.jpg",
      "link": "https://example.com/product/12345",
      "price": "$24.99",
      "ratingCount": 128,
      "score": 0.98
    }
  ]
}
```

### Wine Description

`GET https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/description` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `wine` | query | string | yes | Example: `merlot`. |

#### Quickstart

Look up a wine description by passing the wine name as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/wine-pairing-recommendations-api/food/wine/description?wine=merlot" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `wineDescription` string field containing the description of the wine.

```json
{
  "wineDescription": "Merlot is a dry red wine which is smooth and medium bodied."
}
```

## About

## What it does
Wine Pairing helps you connect wines with foods and food with wines. Send a `food` or `wine` query string, and get back a plain-language pairing summary plus structured match data you can use in an app, menu builder, or recommendation flow.

Use `GET /food/wine/pairing` when you have a dish such as steak and want `pairedWines`, a `pairingText` explanation, and `productMatches` for related wine products. Use `GET /food/wine/dishes` when you already know the wine and need matching `pairings` for dishes, along with a short `text` summary. Both endpoints accept an optional `maxPrice` filter.

For wine discovery, `GET /food/wine/recommendation` accepts `wine` plus optional `number`, `maxPrice`, and `minRating`, then returns `totalFound` and a `recommendedWines` array. Each recommendation includes `id`, `title`, `averageRating`, `description`, `imageUrl`, `link`, `price`, `ratingCount`, and `score`, so you can sort, display, and link out without extra lookups.

`GET /food/wine/description` is the simplest endpoint: send a `wine` string and get a `wineDescription` back. It fits product detail pages, search refinement, and content enrichment where you need a concise wine summary before showing pairings or recommendations.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/skycraft/service/wine-pairing-recommendations-api