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 créditos 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 (pesquisar, categoria, sortingKey, sortingDirection, página, pageSize, includeWlads, shopifyThemes, visitorsCountryRules, storeCreatedFrom / storeCreatedTo, …). Set includeWlads para 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 palavra-chave→pesquisar, ordenar por→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:
imagem(multipart upload), orimage_url(public image URL)
You can include the same optional Explore Shops filters (país, categoria, monthlyRevenue, sortingKey, sortingDirection, página, pageSize, etc.) to narrow visual matches. The response includes similarity-ranked rows and similarity_score.
See also: API reference, Authentication.
MCP tool
| Tool | Função |
|---|---|
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, ou product_taxonomy_l1–l3. |
search_shopify_stores |
Full Explore Shops filter surface over MCP (see MCP tools reference: merchant país, currency, vertical categoria / 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 palavra-chave) 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 (pesquisar, sortingKey, pageSize, includeWlads, …). Full parameter list: MCP · Referência de ferramentas. Setup: MCP.
See also
- API Store tracker — add/remove stores and tracker limits
- Credits & billing — store-explorer metering