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

# Feed API Overview

> Canal 1 — Distribute product catalogs to Google Shopping, Meta Commerce, and OpenAI Commerce.

## What is the Feed API?

The Feed API (Canal 1) lets you distribute product catalogs from Alana to external commerce platforms. Generate product feeds in the format each platform expects — XML for Google Shopping, CSV for Meta, JSON for OpenAI Commerce — without manual data transformation.

## Supported Platforms

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

## Feed Manifest

Discover all available feeds for your workspace:

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

Returns the list of active platforms, last generation timestamp, and feed URLs.

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

  ```javascript JavaScript theme={null}
  const res = await fetch("https://app.alana.shopping/api/v1/manifest", {
    headers: { "X-API-Key": "sk_live_your_api_key" },
  });
  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_your_api_key"},
  )
  manifest = res.json()
  ```
</CodeGroup>

## NDJSON Streaming

For large catalogs, use NDJSON (Newline-Delimited JSON) streaming to process products as they arrive without buffering the full response:

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

Each line in the response is a valid JSON object representing one product. This is ideal for catalogs with thousands of SKUs.

## Feed Generation

Feeds are generated on-demand when requested. Alana caches feeds for 15 minutes to reduce latency for high-frequency consumers. Use `Cache-Control: no-cache` to force regeneration.

## Next Steps

* [Authentication](/en/api-reference/feed/authentication) — API key and Bearer token setup
* [Fetching Feeds](/en/api-reference/feed/fetching-feeds) — Full request/response reference
* [Webhooks](/en/api-reference/feed/webhooks) — Get notified when feeds are ready
* [Analytics](/en/api-reference/feed/analytics) — Track feed consumption metrics