search
Search for products on KuantoKusta.pt with filters for price, brand, and category. Use dynamic filters from the response to refine results by product-specific attributes.
Instructions
Search for products on KuantoKusta.pt — Portugal's main price comparator.
Returns up to 48 products per page plus available_filters showing all
filter options that can be applied to narrow the results. Filters are
dynamic and change per product type — always read available_filters
from the response rather than guessing values.
Recommended workflow:
Call search with just
query(and optionallysort/price range).Read
available_filtersin the response to see areas, brands, and product-specific filters (color, capacity, energy class, typology…).Call search again with the desired filter values to get refined results.
Args:
query: Search keywords, e.g. "frigorífico", "iphone 15", "tv 55 polegadas".
area: Top-level category — use a value from available_filters where
field="area". Example: "Electrodomésticos", "Informática".
family: Sub-category within an area — use a value from available_filters
where field="family". Example: "Grandes Electrodomésticos".
sort: "cheap" (default) | "expensive" | "popular" | "alphabetical" | "newest".
price_min: Minimum price in EUR (integer).
price_max: Maximum price in EUR (integer).
brands: List of brand names — use values from available_filters where
field="brand". Example: ["Samsung", "LG"].
features: Dict of product-type-specific filter values — keys and valid values
come from available_filters where field is NOT area/family/brand.
Example: {"tipologia_s": "combinados", "cor_s": "inox",
"classe_energetica_s": "classe a"}.
For a laptop search the keys would be different (ram_s, os_s, etc.)
— always derive them from the previous call's available_filters.
page: Results page number (default 1; ~48 products per page).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | ||
| page | No | ||
| sort | No | cheap | |
| query | Yes | ||
| brands | No | ||
| family | No | ||
| features | No | ||
| price_max | No | ||
| price_min | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||