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

# Visão Geral da Feed API

> Canal 1 — Distribua catálogos de produtos para Google Shopping, Meta Commerce e OpenAI Commerce.

## O que é a Feed API?

A Feed API (Canal 1) permite distribuir catálogos de produtos do Alana para plataformas externas de comércio. Gere feeds de produtos no formato exigido por cada plataforma — XML para Google Shopping, CSV para Meta, JSON para OpenAI Commerce — sem transformação manual de dados.

## Plataformas Suportadas

| Plataforma      | Formato                      | Endpoint               |
| --------------- | ---------------------------- | ---------------------- |
| Google Shopping | XML (RSS 2.0 + namespace g:) | `/api/v1/feeds/google` |
| Meta Commerce   | CSV                          | `/api/v1/feeds/meta`   |
| OpenAI Commerce | JSON                         | `/api/v1/feeds/openai` |

## Manifesto de Feeds

Descubra todos os feeds disponíveis no seu workspace:

```
GET /api/v1/manifest
```

Retorna a lista de plataformas ativas, timestamp da última geração e URLs dos feeds.

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

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

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

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

## Streaming NDJSON

Para catálogos grandes, use streaming NDJSON para processar produtos conforme chegam, sem carregar a resposta completa em memória:

```bash theme={null}
curl https://app.alana.shopping/api/v1/feeds/google \
  -H "X-API-Key: sk_live_sua_chave_api" \
  -H "Accept: application/x-ndjson"
```

Cada linha da resposta é um objeto JSON válido representando um produto. Ideal para catálogos com milhares de SKUs.

## Geração de Feeds

Os feeds são gerados sob demanda a cada requisição. O Alana armazena feeds em cache por 15 minutos para reduzir a latência de consumidores de alta frequência. Use `Cache-Control: no-cache` para forçar a regeneração.

## Próximos Passos

* [Autenticação](/pt/api-reference/feed/authentication) — Configuração de chave de API e Bearer token
* [Buscando Feeds](/pt/api-reference/feed/fetching-feeds) — Referência completa de requisição/resposta
* [Webhooks](/pt/api-reference/feed/webhooks) — Receba notificações quando os feeds estiverem prontos
* [Analytics](/pt/api-reference/feed/analytics) — Acompanhe métricas de consumo de feed