> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics de Feed

> Acompanhe métricas de consumo — fetches, consumidores únicos, taxa de erro e frequência.

## 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
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.alana.shopping/api/v1/feeds/google/analytics" \
    -H "X-API-Key: sk_live_sua_chave_api"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://app.alana.shopping/api/v1/feeds/google/analytics",
    { headers: { "X-API-Key": "sk_live_sua_chave_api" } }
  );
  const analytics = await res.json();
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://app.alana.shopping/api/v1/feeds/google/analytics",
      headers={"X-API-Key": "sk_live_sua_chave_api"},
  )
  analytics = res.json()
  ```
</CodeGroup>

## Resposta

```json theme={null}
{
  "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

| Campo                 | Tipo     | Descrição                                    |
| --------------------- | -------- | -------------------------------------------- |
| `total_fetches`       | inteiro  | Total de downloads do feed no período        |
| `unique_consumers`    | inteiro  | Número de IPs/agentes consumidores distintos |
| `avg_frequency_hours` | decimal  | Média de horas entre fetches                 |
| `error_rate`          | decimal  | Fração de requisições com erro (0–1)         |
| `last_fetch_at`       | ISO 8601 | Timestamp do fetch mais recente              |
| `product_count_trend` | array    | Snapshots diários de contagem de produtos    |

## Parâmetros de Query

| Parâmetro | Padrão | Descrição                      |
| --------- | ------ | ------------------------------ |
| `days`    | `30`   | Janela 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:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.alana.shopping/api/v1/feeds/analytics" \
    -H "X-API-Key: sk_live_sua_chave_api"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://app.alana.shopping/api/v1/feeds/analytics",
    { headers: { "X-API-Key": "sk_live_sua_chave_api" } }
  );
  const resumo = await res.json();
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://app.alana.shopping/api/v1/feeds/analytics",
      headers={"X-API-Key": "sk_live_sua_chave_api"},
  )
  resumo = res.json()
  for plataforma in resumo["platforms"]:
      print(plataforma["platform"], plataforma["total_fetches"])
  ```
</CodeGroup>