Pular para o conteúdo principal

​
Visão Geral

O analytics de feed oferece visibilidade sobre como plataformas externas estão consumindo seus feeds de produtos — com que frequência, por quem e com qual taxa de sucesso.

​
Endpoint

GET /api/v1/feeds/{platform}/analytics

curl "https://app.alana.shopping/api/v1/feeds/google/analytics" \
  -H "X-API-Key: sk_live_sua_chave_api"

​
Resposta

{
  "platform": "google",
  "period": {
    "from": "2026-02-17T00:00:00Z",
    "to": "2026-03-17T23:59:59Z"
  },
  "total_fetches": 2847,
  "unique_consumers": 3,
  "avg_frequency_hours": 6.2,
  "error_rate": 0.004,
  "last_fetch_at": "2026-03-17T11:45:00Z",
  "product_count_trend": [
    { "date": "2026-03-15", "count": 1420 },
    { "date": "2026-03-16", "count": 1428 },
    { "date": "2026-03-17", "count": 1432 }
  ]
}

​
Campos da Resposta

CampoTipoDescrição
total_fetchesinteiroTotal de downloads do feed no período
unique_consumersinteiroNúmero de IPs/agentes consumidores distintos
avg_frequency_hoursdecimalMédia de horas entre fetches
error_ratedecimalFração de requisições com erro (0–1)
last_fetch_atISO 8601Timestamp do fetch mais recente
product_count_trendarraySnapshots diários de contagem de produtos

​
Parâmetros de Query

ParâmetroPadrãoDescrição
days30Janela de lookback (máx: 90)
from—Data inicial (ISO 8601)
to—Data final (ISO 8601)

​
Retenção de Dados

Os dados de analytics são retidos por 90 dias.

​
Resumo de Todas as Plataformas

Para obter analytics de todas as plataformas de uma vez: 
curl "https://app.alana.shopping/api/v1/feeds/analytics" \
  -H "X-API-Key: sk_live_sua_chave_api"
Last modified on March 18, 2026