Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text in Dutch or English, matched against wine name, winery, grape, region, country, type and vintage, e.g. \"amarone\" or \"red wine tuscany\". Taste, food and budget words are not matched; use the filters, food and sort for those.",
"type": "string",
"maxLength": 200
},
"type": {
"description": "Wine type. \"sparkling\" includes Champagne.",
"type": "string",
"enum": [
"red",
"white",
"rose",
"sparkling",
"champagne",
"dessert"
]
},
"country": {
"description": "Country name in Dutch or English, or ISO code, e.g. \"IT\".",
"type": "string",
"maxLength": 60
},
"region": {
"description": "Region, e.g. \"Toscane\", \"Tuscany\" or \"Bordeaux\".",
"type": "string",
"maxLength": 100
},
"grape": {
"description": "Grape variety, e.g. \"Nebbiolo\".",
"type": "string",
"maxLength": 60
},
"food": {
"description": "Dish or food in Dutch or English, e.g. \"seafood\", \"oysters\", \"lamb\", \"cheese\", \"pasta\" or \"aperitif\". Matches whole words and word prefixes in food_pairing, the pairing sentence quoted from each wine description, with a few synonyms (fish/vis, seafood/zeevruchten, meat/vlees, cheese/kaas). Wines whose description names no dish are left out.",
"type": "string",
"maxLength": 100
},
"min_price_eur": {
"description": "Lowest verified bottle price in EUR. Wines without a verified current price are left out when a price filter is set.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"max_price_eur": {
"description": "Highest verified bottle price in EUR. Wines without a verified current price are left out when a price filter is set.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"available_only": {
"description": "Only wines that can be ordered online now. Default false.",
"type": "boolean"
},
"sort": {
"description": "Sort order. Default \"relevance\"; without a query, editorial picks come first.",
"type": "string",
"enum": [
"relevance",
"price_asc",
"price_desc",
"rating"
]
},
"limit": {
"description": "Maximum number of results, 1-20. Default 8.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"language": {
"description": "Response language: \"nl\" (Dutch, default) or \"en\" (English).",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}