Docs
Ctrl+K Rechercher Alt+[Alt+] Guides
Obtenir une clé API

API · Shopify

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 générique 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 (rechercher, catégorie, 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 mot-clé→rechercher, sort_by→sortingKey, taille→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), or
  • image_url (public image URL)

You can include the same optional Explore Shops filters (pays, catégorie, 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 Référence des outils MCP: merchant pays, currency, vertical catégorie / 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 mot-clé) 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 (rechercher, sortingKey, pageSize, includeWlads, …). Full parameter list: MCP · tools reference. Setup: MCP.

See also