list_tracked_shops
List the shops available in the current WhatWins workspace with organization-scoped IDs and headline metrics.
Use list_tracked_shops when the user asks which shops they track, needs valid IDs for another tool, or wants to filter their tracker by a name or niche.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
storeIds | [] | Yes | Always empty; access comes from the authorized organization |
query | string | No | Optional name, domain or category filter, 2–120 characters |
limit | number | Yes | 1–50 shops |
sort | enum | Yes | recent, traffic, live_ads, name |
Example call
{
"storeIds": [],
"query": "skincare",
"limit": 25,
"sort": "traffic"
}Result behavior
Results are scoped to the authenticated organization. Rows can include tracker status, folder context and headline traffic or live-ad metrics when WhatWins has verified coverage.
Use the returned IDs in later tracked-shop calls. Never reuse an ID supplied by another workspace or infer access from a raw ID.
Credits
The tool reserves the requested result limit and settles against the rows returned.