Analytics

Accede a métricas y estadísticas de búsqueda.

Resumen de métricas

GET /api/shops/{shopId}/analytics/summary

Headers

X-Shop-API-Key: YOUR_API_KEY

Query params

Param	Tipo	Descripción
from	string	Fecha inicio (ISO 8601)
to	string	Fecha fin (ISO 8601)

Response

{
  "period": {
    "from": "2024-01-01T00:00:00Z",
    "to": "2024-01-31T23:59:59Z"
  },
  "totalSearches": 15420,
  "totalClicks": 4326,
  "ctr": 28.05,
  "uniqueUsers": 8540,
  "avgQueryLength": 3.2
}

---

Top búsquedas

GET /api/shops/{shopId}/analytics/top-queries

Query params

Param	Tipo	Descripción
from	string	Fecha inicio
to	string	Fecha fin
limit	number	Número de resultados (default: 10)

Response

{
  "queries": [
    {
      "query": "zapatillas running",
      "count": 542,
      "clicks": 187,
      "ctr": 34.5
    },
    {
      "query": "camisetas nike",
      "count": 328,
      "clicks": 95,
      "ctr": 28.9
    }
  ]
}

---

Top productos

GET /api/shops/{shopId}/analytics/top-products

Response

{
  "products": [
    {
      "productId": "prod_123",
      "name": "Nike Air Max 90",
      "views": 1250,
      "clicks": 342,
      "ctr": 27.4
    }
  ]
}

---

Búsquedas sin resultados

GET /api/shops/{shopId}/analytics/zero-results

Identifica qué buscan los usuarios que no encuentran.

Response

{
  "queries": [
    {
      "query": "sudadera roja",
      "count": 45,
      "lastSearched": "2024-01-15T14:30:00Z"
    }
  ]
}

---

Ejemplo

# Obtener resumen del último mes
curl -X GET "https://api.neuroon.ai/api/shops/shop_123/analytics/summary?from=2024-01-01&to=2024-01-31" \
  -H "X-Shop-API-Key: sk_live_abc123"

Notas

• Los datos se actualizan cada hora
• Histórico disponible según tu plan
• Para analytics en tiempo real, contacta con ventas