Find cheapest products
tl_find_cheapestFind in-stock products matching a query and return one flat list sorted by discounted price. Narrow results by category, brand, and price range.
Instructions
Find the cheapest in-stock products for a search, one flat list sorted by the price after discount.
Accessories often match a model name: check categories and brands, then call again with
category_code and brand_codes. Prices are the featured offer: confirm with tl_product.
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": {
"query": "<query>"
},
"name": "tl_find_cheapest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max products to return. | |
| pages | No | Pages of 100 results to scan. | |
| query | Yes | Product name, Persian or English, e.g. 'آیفون 16'. | |
| max_price | No | Highest price in Toman, e.g. 150000000. | |
| min_price | No | Lowest price in Toman, e.g. 50000000. | |
| brand_codes | No | Codes from `brands` of a result or tl_find_brand, e.g. [16, 19]. | |
| category_code | No | Code from `categories` of a result, e.g. 1 (phones), to skip accessories. |