---
title: "Recommend beers based on a query"
method: GET
path: "/api/beers/recommend"
---

# Recommend beers based on a query

`GET /api/beers/recommend`

Returns the top 5 beer recommendations matching the natural language query, considering flavor profiles, food pairings, and beer styles.

## Query parameters

- `query` string, required

## Response `200`

List of recommended beers

- Beer[]
  - `id` string, required
  - `name` string, required
  - `style` string, required
  - `brewery` string, required
  - `country` string, required
  - `abv` number, float, required
  - `description` string, required
  - `flavorNotes` string[], required
  - `pairingNotes` string[], required

## Other responses

- `400` — Missing required query parameter

---

[API](https://skmtc.net/azure/apis/contoso-world-beers-api.md) · [All operations](https://skmtc.net/azure/apis/contoso-world-beers-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/contoso-world-beers-api/versions/13ac7d7d14c5/schema)