Store explorer
WinningHunter tracks Shopify stores for revenue, traffic, and bestsellers (Sales tracker / Explore shops in the app).
REST (API key)
POST /api/v1/store-explorer — API key (same credits and auth as other programmatic endpoints). Request shape matches Explore shops in the dashboard; copy a working request from the app’s network tab if in doubt. Rows include an estimated_revenue object with daily and monthly min/max estimates.
Dashboard / session API: POST /api/shops/explore (same host as the app, e.g. https://app.winninghunter.com/api/shops/explore) uses the same POST field names as the Explore Shops UI (search, category, sortingKey, sortingDirection, page, pageSize, includeWlads, shopifyThemes, visitorsCountryRules, storeCreatedFrom / storeCreatedTo, …). Set includeWlads to 0 on the main table request to skip per-store Meta wlads preview enrichment. MCP search_shopify_stores / search_shops send the same body shape programmatically: tool args keyword→search, sort_by→sortingKey, size→pageSize, default include_wlads=false ↔ includeWlads=0.
POST /api/v1/store-explorer/visual-search — image-based store similarity search for Shopify stores.
Send either:
image(multipart upload), orimage_url(public image URL)
You can include the same optional Explore Shops filters (country, category, monthlyRevenue, sortingKey, sortingDirection, page, pageSize, etc.) to narrow visual matches. The response includes similarity-ranked rows and similarity_score.
See also: API reference, Authentication.
MCP tool
| Tool | Role |
|---|---|
list_shopify_store_filter_options |
Returns exact Store Explorer filter options: static enums, range presets, and dynamic Shopify themes, store apps, and product taxonomy facets. Use this before filtering by shopify_themes, store_apps, or product_taxonomy_l1–l3. |
search_shopify_stores |
Full Explore Shops filter surface over MCP (see MCP tools reference: merchant country, currency, vertical category / niche, optional product_taxonomy_l1–l3, visitor visitor_country_*, revenue, AOV, visits, product count, language, apps, Trustpilot, revenue-change %, traffic-growth JSON rules, store-created date range, Shopify themes, sort/pagination). |
find_similar_stores_by_image |
Same filters as above (no text keyword) plus required image_url. |
Uses the same search and pagination model as POST /api/v1/store-explorer and the dashboard POST /api/shops/explore POST keys (search, sortingKey, pageSize, includeWlads, …). Full parameter list: MCP · tools reference. Setup: MCP.
See also
- API Store tracker — add/remove stores and tracker limits
- Credits & billing — store-explorer metering