Get current deals
get_dealsRead-onlyIdempotent
Lists current deals in a country: products whose price is well below their usual price or clearly lower at one store than at the others, and the biggest price drops of the past week. With store, only that store's deals, plus its own offers page (its weekly offers) when it has one running. Can be narrowed to a product category.
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>"
},
"name": "get_deals"
}
}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 in each list (1 to 20, default 8). | |
| store | No | Only this store's deals. 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| country | Yes | ||
| currency | Yes | ||
| topDeals | Yes | prices well below their usual, or clearly cheaper at one store | |
| storeOffers | No | the store's own offers page, when a store was asked about and has one running | |
| biggestDrops | Yes | the biggest price drops of the past week |