Search products and prices
search_productsRead-onlyIdempotent
Searches Basko's price database for products sold by stores in one country and returns, for each product, its listings ordered by price (cheapest in-stock first), the number of stores selling it, the size and price per kilogram, litre or piece when known, and links to the listings. Use it to find what a product costs or which store sells it for less. Results are ordered by how well they match the words.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>",
"query": "<query>"
},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of texts and amounts in the answer, as a BCP 47 tag (en, ru, uz, uz-Cyrl, kk, es, …). Default: the assistant's locale, else the country's main language. | |
| limit | No | How many products (1 to 20, default 8). | |
| query | Yes | What to look for, in any language ("oat milk", "гречка", "iPhone 17 128GB"). | |
| store | No | Only this store's listings. Store ids come from find_stores (korzinka, walmart-us, tesco-uk, …). | |
| country | Yes | The country whose stores to read: UZ (Uzbekistan), KZ (Kazakhstan), RU (Russia), US (United States), GB or UK (United Kingdom). | |
| category | No | Only products of this category. | |
| maxPrice | No | Only listings at or under this price, in the country's currency (dollars, pounds, so'm, tenge, roubles). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| query | Yes | ||
| country | Yes | ||
| currency | Yes | ||
| products | Yes |