Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional words from a brand or model name, for example nox at10. Leave absent for a budget/style search without a named model. Express price, year and rating constraints with their structured fields."
},
"brand": {
"type": "string"
},
"year": {
"type": "integer",
"description": "Exact model year, for example 2027"
},
"shape": {
"type": "string",
"enum": [
"round",
"teardrop",
"diamond",
"hybrid"
]
},
"maxPrice": {
"type": "number",
"description": "Highest observed price. Needs currency."
},
"currency": {
"type": "string",
"description": "Three-letter currency explicitly established by the user or prior conversation, for example EUR or USD. A bare dollar sign is ambiguous: ask which dollar currency before a price-filtered search. Do not infer currency from the server country, browser locale or available catalogue prices. No exchange rate is applied."
},
"minPower": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Lowest calculated power rating"
},
"minControl": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Lowest calculated control rating"
},
"minHandling": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Lowest calculated handling rating"
},
"minForgiveness": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Lowest calculated forgiveness rating"
},
"minComfort": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Lowest calculated comfort rating"
},
"sort": {
"type": "string",
"enum": [
"power",
"control",
"handling",
"forgiveness",
"comfort"
],
"description": "A calculated rating to prioritise. Select from the buyer's stated preference; explain the ordering rule. If no preference was supplied, default name order is browsing, not a best-match ranking."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Default 3, at most 10"
}
},
"additionalProperties": false
}