discover_shops
Find untracked specialist shops by niche, country, traffic, live-ad activity and ecommerce platform.
Use discover_shops when the user wants new competitors or specialist stores they have not already added to Shop Tracker.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
storeIds | [] | Yes | Always empty for global discovery |
query | string | Yes | Product niche, 2–120 characters |
limit | number | Yes | 1–8 |
sort | enum | Yes | relevance, traffic, live_ads |
countries | string[] | Yes | Zero to eight uppercase country codes |
minTraffic | number | No | Non-negative monthly-traffic threshold |
minLiveAds | number | No | Non-negative observed live-ad threshold |
shopifyOnly | boolean | Yes | Restrict to detected Shopify shops |
Example call
{
"storeIds": [],
"query": "creatine gummies",
"limit": 6,
"sort": "traffic",
"countries": ["US", "GB"],
"minTraffic": 100000,
"minLiveAds": 10,
"shopifyOnly": true
}Good prompt
Discover 6 Shopify stores selling creatine gummies in the US or UK.
Require at least 100k monthly visits and 10 live ads, then rank by traffic.Result behavior
Shops already tracked by the connected organization are excluded. A returned shop is a research result only; it is not added to Shop Tracker until a user explicitly tracks it in WhatWins.
Traffic and live-ad thresholds are competitive filters, not proof of revenue or spend.
Credits
The tool reserves the requested limit and settles against the number of shops actually returned.