Documentos
Ctrl+K Buscar Alt+[Alt+] Guías
Obtener clave API

API · Shopify

Explorador de tiendas

Search Shopify stores by revenue, traffic, category, and more. MCP equivalents: buscar_tiendas_de_Shopify, buscar_tiendas_similares_por_imagen, list_shopify_store_filter_options.

PUBLICAR/api/v1/store-explorer

Search Shopify stores. The body matches the Explore Shops UI.

Send Clave X-API on every request.

Body parameters

  • buscarcadenaoptional

    Keyword to match store name or products.

  • paíscadenaoptional

    Merchant country (ISO2) or All.

  • clave de ordenacióncadenaoptional

    Sort field.

    Por defecto ingresos_30d
  • dirección de ordenacióncadenaoptional
    Por defecto desc·Valores desc asc
  • páginaenterooptional
  • tamaño de páginaenterooptional
  • includeWladsenterooptional

    Set 0 to skip Meta ad enrichment.

Solicitud
curl -sS \
  -X POST \
  -H "X-API-Key: $WH_API_KEY" \
  -H "Content-Type: application/json" \
  "{origin}/api/v1/store-explorer" \
  -d '{"search":"skincare","country":"US","sortingKey":"revenue_30d","sortingDirection":"desc","page":1,"pageSize":20,"includeWlads":0}'
const res = await fetch(`${ORIGIN}/api/v1/store-explorer`, {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.WH_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "search": "skincare",
      "country": "US",
      "sortingKey": "revenue_30d",
      "sortingDirection": "desc",
      "page": 1,
      "pageSize": 20,
      "includeWlads": 0
  }),
});
const data = await res.json();
import os, requests

res = requests.post(
    f"{ORIGIN}/api/v1/store-explorer",
    headers={"X-API-Key": os.environ["WH_API_KEY"]},
    json={
        "search": "skincare",
        "country": "US",
        "sortingKey": "revenue_30d",
        "sortingDirection": "desc",
        "page": 1,
        "pageSize": 20,
        "includeWlads": 0
    },
)
data = res.json()
Respuesta
{
    "success": true,
    "data": [
        {
            "shop_id": "glow-beauty",
            "domain": "glowbeauty.com",
            "country": "US",
            "monthly_visits": 412000,
            "estimated_revenue": {
                "daily_min": 4200,
                "daily_max": 6800,
                "monthly_min": 126000,
                "monthly_max": 204000
            }
        }
    ],
    "page": 1,
    "total": 20
}
{
    "success": false,
    "error": "Unauthorized"
}
PUBLICAR/api/v1/store-explorer/visual-search

Find visually similar Shopify stores from a product image.

Send Clave X-API on every request.

Body parameters

  • url_de_la_imagencadenaoptional

    Public image URL. Provide this or an imagen multipart upload.

  • paíscadenaoptional

    Optional Explore Shops filter.

Solicitud
curl -sS \
  -X POST \
  -H "X-API-Key: $WH_API_KEY" \
  -H "Content-Type: application/json" \
  "{origin}/api/v1/store-explorer/visual-search" \
  -d '{"image_url":"https://example.com/product.jpg","country":"US"}'
const res = await fetch(`${ORIGIN}/api/v1/store-explorer/visual-search`, {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.WH_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "image_url": "https://example.com/product.jpg",
      "country": "US"
  }),
});
const data = await res.json();
import os, requests

res = requests.post(
    f"{ORIGIN}/api/v1/store-explorer/visual-search",
    headers={"X-API-Key": os.environ["WH_API_KEY"]},
    json={
        "image_url": "https://example.com/product.jpg",
        "country": "US"
    },
)
data = res.json()
Respuesta
{
    "success": true,
    "data": [
        {
            "shop_id": "glow-beauty",
            "domain": "glowbeauty.com",
            "similarity_score": 0.92
        }
    ]
}

Puedes incluir los mismos filtros opcionales de «Explorar tiendas» (categoría, Ingresos mensuales, shopifyThemes, storeCreatedFrom/storeCreatedTo, visitorsCountryRules, …) on either route. Use list_shopify_store_filter_options over MCP to discover valid filter values.

Véase