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

# Quickstart

> Make your first authenticated FacetFlux API call in a couple of minutes.

This guide gets you from zero to a working API call. You'll need a FacetFlux account on a paid plan ([API access is included](https://facetflux.com/pricing)).

## 1. Create an API key

Sign in at [app.facetflux.com](https://app.facetflux.com) as a tenant admin, go to **Settings → API keys**, and create a key. Copy it now — it's shown only once. For a first read-only test, a **read-only** key is enough. See [Authentication](/authentication) for the full details.

```bash theme={null}
export FACETFLUX_API_KEY="your-key-here"
```

## 2. Read your catalog

Every response is scoped to the tenant your key belongs to. List the first page of products:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.facetflux.com/api/v1/public/products" \
    -H "Authorization: Bearer $FACETFLUX_API_KEY"
  ```

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

  BASE = "https://app.facetflux.com"
  headers = {"Authorization": f"Bearer {os.environ['FACETFLUX_API_KEY']}"}

  resp = requests.get(f"{BASE}/api/v1/public/products", headers=headers)
  resp.raise_for_status()
  print(resp.json())
  ```

  ```typescript TypeScript theme={null}
  const BASE = "https://app.facetflux.com";
  const headers = { Authorization: `Bearer ${process.env.FACETFLUX_API_KEY}` };

  const resp = await fetch(`${BASE}/api/v1/public/products`, { headers });
  if (!resp.ok) throw new Error(`${resp.status} ${await resp.text()}`);
  console.log(await resp.json());
  ```
</CodeGroup>

If you get a `401`, the key is missing or wrong. A `403 read_only_api_key` means you tried a write with a read-only key.

## 3. Pick your path

<CardGroup cols={2}>
  <Card title="Run a diagnostic" icon="stethoscope" href="/guides/diagnostics">
    Upload a catalog file and get a completeness report. The best first look at your data.
  </Card>

  <Card title="Enrich products" icon="wand-magic-sparkles" href="/guides/enrichment">
    Fill missing specs and classify to ETIM / eCl\@ss with AI.
  </Card>

  <Card title="Export your catalog" icon="file-export" href="/guides/exports">
    Generate BMEcat, CSV, or channel-specific output.
  </Card>

  <Card title="Hand it to an agent" icon="robot" href="/mcp">
    Connect the MCP server and let an AI agent do the work.
  </Card>
</CardGroup>

<Tip>
  Prefer to click through the endpoints? The [API reference](/api-reference/introduction) has an interactive playground — paste your key once and try any call in the browser.
</Tip>