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

# Quickstart

> Get up and running with Alana Shopping B2B API in under 5 minutes.

## 1. Create your workspace

Sign up at [app.alana.shopping](https://app.alana.shopping) and complete the onboarding flow. You'll be guided through:

* Naming your workspace
* Setting your industry and company size
* Optionally loading sample catalog data to explore

## 2. Generate an API key

Navigate to **Settings > API Keys** in your workspace dashboard, or use the setup endpoint after authentication.

<Steps>
  <Step title="Go to API Keys">
    Open your workspace settings and click **API Keys** in the sidebar.
  </Step>

  <Step title="Create a key">
    Click **Create API Key**, give it a name (e.g. `dev-local`), and select the permissions you need.
  </Step>

  <Step title="Copy the key">
    Your API key is shown **once**. Copy it and store it securely.
  </Step>
</Steps>

<Warning>
  API keys are shown only at creation time. If you lose your key, revoke it and create a new one.
</Warning>

## 3. Make your first request

Verify your key works by fetching your workspace settings:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.alana.shopping/api/workspace/{workspaceId}/settings" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    `https://app.alana.shopping/api/workspace/${workspaceId}/settings`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
      },
    }
  );
  const workspace = await response.json();
  console.log(workspace);
  ```

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

  response = requests.get(
      f"https://app.alana.shopping/api/workspace/{workspace_id}/settings",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
  )
  print(response.json())
  ```
</CodeGroup>

## 4. Create your first brand

Brands organize your product content and carry AI specs (tone, keywords, policies).

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/brands" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Brand",
    "description": "Premium lifestyle products"
  }'
```

## 5. Create a catalog and add products

```bash theme={null}
# Create a catalog
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring 2026 Collection",
    "brandId": "BRAND_ID_FROM_STEP_4"
  }'

# Add a product
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalog/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "catalogId": "CATALOG_ID",
    "title": "Classic Cotton Tee",
    "description": "100% organic cotton t-shirt",
    "brand": "My Brand",
    "price": 29.99,
    "currency": "USD",
    "sku": "CCT-001"
  }'
```

## 6. Generate AI content

Use the AI engine to enhance your product description, with brand-aware context:

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/ai/enhance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "100% organic cotton t-shirt",
    "type": "description",
    "brandId": "BRAND_ID"
  }'
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication deep-dive" icon="lock" href="/authentication">
    Learn about API keys, session auth, and scopes.
  </Card>

  <Card title="Import products in bulk" icon="upload" href="/guides/product-import">
    Upload CSV/Excel files with thousands of products.
  </Card>

  <Card title="Set up AI specs" icon="sparkles" href="/concepts/ai-engine">
    Configure brand tone, keywords, and policies for AI generation.
  </Card>

  <Card title="Explore the API" icon="code" href="/api-reference/overview">
    Interactive playground with all 90+ endpoints.
  </Card>
</CardGroup>