search_products
Search Partle's catalog of hardware and tools by name, description, or semantic query. Filter by price, store, and tags to locate products in physical stores.
Instructions
Search Partle's product catalog by name or description.
Use this when the user asks to find a specific product or browse
products matching a query. Prefer this over search_stores when the
intent is product-led ("find a drill") rather than store-led ("what
stores are near Madrid"). Use get_product afterwards if the user
wants full details for one specific result.
Read-only. No authentication. Rate-limited to 100 requests/hour per IP.
Args:
query: Free-text search term (e.g. "wireless headphones", "cerrojo
FAC", "drill bit"). Required even in semantic mode.
min_price: Lower bound on price in EUR. Omit for no lower bound.
max_price: Upper bound on price in EUR. Omit for no upper bound.
tags: Comma-separated tag filter (e.g. "electronics,bluetooth").
Tags are AND-ed together.
store_id: Restrict results to a single store. Use the integer id
field from search_stores results.
sort_by: One of price_desc, name_asc, newest, oldest. Omit
to use the default search-relevance ranking.
semantic: When True, runs a vector / cross-language search. Set
this when the user's query may not match the listing language —
e.g. "drill" in English will also surface "taladro" (Spanish) and
"Bohrmaschine" (German). Pure-English catalogs benefit less.
limit: Maximum results (1–100, default 20). Larger limits are slower
and may exceed the rate budget faster.
offset: Skip this many results before returning. Use for pagination
(offset += limit on each follow-up call).
Returns:
{"result": [Product, …]}. Each product includes id, name,
price, currency, url, description, store (id / name /
country), images, tags, and a canonical partle_url. Always
share partle_url with the user so they can view the listing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| min_price | No | ||
| max_price | No | ||
| tags | No | ||
| store_id | No | ||
| sort_by | No | ||
| semantic | No | ||
| limit | No | ||
| offset | No |