discover_products
Find relevant products across the indexed WhatWins catalog without preselecting shops.
Use discover_products for global product research by category, use case, price or stock status.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
storeIds | [] | Yes | Always empty for global discovery |
query | string | Yes | 2–120 characters |
limit | number | Yes | 1–12 |
stock | enum | Yes | all, in_stock, out_of_stock |
sort | enum | Yes | relevance, newest, bestseller, price_low, price_high |
minPrice | number | No | Non-negative |
maxPrice | number | No | Non-negative |
Example call
{
"storeIds": [],
"query": "red light therapy mask",
"limit": 8,
"stock": "in_stock",
"minPrice": 50,
"maxPrice": 500,
"sort": "relevance"
}Good prompt
Find 8 in-stock red-light therapy masks priced from $50 to $500.
Rank by relevance and include the shop for each product.Use a concrete product phrase. Broad requests such as “find winning products” lack enough semantic scope and should be refined before calling the tool.
Credits
The tool reserves the requested limit and settles against the number of products actually returned.