Search retail products
search_productsSearch products for sale at big retailers and well-known brand stores: Myer, JB Hi-Fi, Zappos, Nike and about 180 more, deepest in Australia and US fashion. Use this when a shopper wants a product, a price check, or somewhere to buy it. Put the product in query (2 to 4 words, brand first: 'sony headphones', 'breville espresso machine') and budget, country, size and colour in their own fields. Returns ranked listings with title, store, price, availability, the retailer's product url and when it was last checked, plus retailer_search links to try when nothing matches. Prices are in each listing's own currency, exclude shipping and tax, and are not converted. No key needed. Example: {"query": "espresso machine", "country": "AU", "max_price": 600}.
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": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| need | No | Optional. What the shopper needs, in one sentence: 'quiet, fits under a 40 cm cabinet'. Not used to filter. When nothing fits, it tells exNiche exactly what is missing. No personal details. | |
| size | No | Size exactly as a store would list it, e.g. M, 8, 10.5. Only listings with that recorded size are returned, so leave it out for a wider search. | |
| sort | No | price sorts need currency or country. | relevance |
| color | No | Colour as a store would list it, e.g. black. | |
| limit | No | ||
| query | Yes | The product in 2 to 4 words, brand first if the shopper named one: 'sony headphones', 'breville espresso machine', 'running shoes'. Put budget, country, size and colour in their own fields, not here. | |
| country | No | Shopper's country as a two-letter code, e.g. AU or US. Limits results to listings priced in that country's currency. | |
| details | No | true = full rows (description, every matching variant). Several times larger; leave off unless needed. | |
| currency | No | Three-letter currency code, e.g. AUD. Only listings priced in it are returned. | |
| in_stock | No | true = only listings seen in stock in the last 72 hours. This drops most listings; leave it out and check stock on the retailer page. | |
| max_price | No | Highest price, in `currency` (or the country's currency). Needs currency or country. No currency conversion is done. | |
| min_price | No | Lowest price, in `currency` (or the country's currency). Useful to skip accessories. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| note | No | ||
| count | No | ||
| found | No | false = nothing in this catalogue matched; not proof nobody sells it | |
| query | No | ||
| results | No | ||
| human_message | No | ||
| retailer_search | No |