API Documentation | AgentSomm

GET /api/recommend

Wine recommendations by preference, budget, occasion, food pairing

Parameters

preferences string Free-text: "bold red for steak"

budget string Price range: "under $30", "$15-25"

occasion string "dinner party", "casual", "bbq"

food_pairing string "grilled steak", "seafood"

color string red, white, rose, sparkling

varietal string "cabernet sauvignon", "chardonnay"

region string "Napa Valley", "Lodi"

limit int Results to return (1-50, default 5)

Example

/api/recommend?preferences=bold+red&food_pairing=steak&budget=under+%2430

GET /api/search

Search wines by name, varietal, region, price, or medal level

Parameters

q string Free-text search query

color string Filter by color

varietal string Filter by grape variety

region string Filter by region/country

min_price float Minimum price

max_price float Maximum price (0 = no limit)

medal_level string Minimum medal: bronze/silver/gold/double_gold

limit int Results to return (1-100, default 10)

Example

/api/search?varietal=pinot+noir&region=oregon&medal_level=gold

GET /api/wine/{id}

Full wine details with medal history by database ID

Parameters

id int Wine database ID (path parameter)

Example

/api/wine/42

GET /api/wine

Look up a wine by name with optional disambiguation

Parameters

name string Wine name (required)

producer string Producer name for disambiguation

vintage int Vintage year (0 = any)

Example

/api/wine?name=earthquake+zinfandel&producer=michael+david

GET /api/compare

Side-by-side comparison of two or more wines

Parameters

wines string Comma-separated wine names

Example

/api/compare?wines=earthquake+zinfandel,gnarly+head+zinfandel

GET /api/food-pairing

Wine recommendations for a specific dish

Parameters

dish string "grilled steak", "seafood", "pasta"

Example

/api/food-pairing?dish=grilled+steak

GET /api/stats

Database statistics: wine count, medal count, competitions, breakdowns

Example

/api/stats