Pular para o conteúdo principal

Endpoint

GET /api/hub/catalogs/{catalogId}/analytics
Retorna métricas de performance para um catálogo publicado. Requer autenticação — apenas o workspace publisher pode acessar analytics do seu próprio catálogo.

Parâmetros de path

ParâmetroTipoObrigatórioDescrição
catalogIdstringSimID do catálogo publicado

Parâmetros de query

ParâmetroTipoPadrãoDescrição
daysnumber30Janela de lookback (máx: 90)

Resposta

{
  "period_days": 30,
  "views": 842,
  "previews": 156,
  "clones": 23,
  "activeSubscribers": 34,
  "newSubscribers": 8,
  "churnedSubscribers": 2,
  "syncEvents": 45,
  "conflictsGenerated": 12,
  "topSearchTerms": [
    { "term": "vestuário feminino", "count": 89 },
    { "term": "camisetas algodão", "count": 67 }
  ]
}

Exemplos

curl "https://app.alana.shopping/api/hub/catalogs/hub_cat_9x8k2m/analytics?days=30" \
  -H "Authorization: Bearer sk_live_sua_chave_api"

Respostas de erro

Status HTTPCódigoDescrição
403INSUFFICIENT_PERMISSIONSNão é o publisher deste catálogo
404CATALOG_NOT_FOUNDCatálogo não encontrado ou despublicado
Last modified on March 18, 2026