Search products
search_productsSearch marketplace products by text and filters to compare prices, ratings, and reviews; returns product cards, total counts, and optional categories/facets for narrowing results.
Instructions
Search a marketplace for products by text and/or filters. Returns product cards (id, title, lowest price, rating, review count, link), the total count, and on request the available categories and facets whose value ids can be passed back in filters to narrow the search. Pages are 0-based.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name, code or id (e.g. 'Алматы', 'almaty', '750000000'). Prices, sellers and delivery depend on it. Omit to use the configured default city. Ask the user where they are if it matters and is unknown. | |
| page | No | 0-based page number. | |
| sort | No | Sort order; see sortOptions in list_marketplaces (e.g. relevance, price-asc, price-desc, rating, created-desc). | |
| query | No | Search text. May be omitted when browsing by `filters` only. | |
| filters | No | Category/facet value ids exactly as returned in `categories` or `facets` of a previous search, e.g. [':category:Smartphones', ':manufacturerName:Apple']. | |
| marketplace | No | Marketplace id from list_marketplaces. | kaspi |
| include_facets | No | Also return categories and facets available for this search (larger response; first page only). |