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

# Quickstart

> Make your first Spotlight API call in under 2 minutes.

## Get your API key

1. Open the Spotlight app and go to **Settings → API**.
2. Copy your API key.
3. Note your **API Base URL** — it looks like `https://app.get-spotlight.com/api`.

## Verify connectivity

Call the root discovery endpoint to confirm your key works and see what's available:

<CodeGroup>
  ```bash cURL theme={null}
  curl -s \
    -H "x-spotlight-api-key: YOUR_API_KEY" \
    "https://app.get-spotlight.com/api/"
  ```

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

  BASE_URL = "https://app.get-spotlight.com/api"
  HEADERS  = {"x-spotlight-api-key": "YOUR_API_KEY"}

  r = requests.get(f"{BASE_URL}/", headers=HEADERS)
  print(r.json())
  ```

  ```javascript JavaScript theme={null}
  const BASE_URL = "https://app.get-spotlight.com/api";
  const HEADERS  = { "x-spotlight-api-key": "YOUR_API_KEY" };

  const r = await fetch(`${BASE_URL}/`, { headers: HEADERS });
  console.log(await r.json());
  ```
</CodeGroup>

**Response:**

```json theme={null}
{
  "message": "Spotlight Data API",
  "version": "v1",
  "organizationId": "00000000-0000-0000-0000-000000000000",
  "endpoints": [
    { "method": "GET",    "path": "/v1/brands" },
    { "method": "GET",    "path": "/v1/brands/{brandId}/runs" },
    { "method": "GET",    "path": "/v1/runs/{runId}" }
  ]
}
```

## Fetch your brands

```bash theme={null}
curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/brands"
```

Save the `id` field from the brand you want to work with — you'll use it as `{brandId}` in most other endpoints.

## Pull the latest analysis results

```bash theme={null}
curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/brands/BRAND_ID/last/results"
```

## Next steps

<CardGroup cols={2}>
  <Card title="Runs" icon="chart-bar" href="/api-reference/runs/list">
    Browse the full history of analysis runs.
  </Card>

  <Card title="Content suggestions" icon="lightbulb" href="/api-reference/content-suggestions/get-run-suggestions">
    Sync AI-generated content ideas into your backlog.
  </Card>

  <Card title="Sources" icon="link" href="/api-reference/sources/get-run-sources">
    See which URLs are driving brand perception.
  </Card>

  <Card title="Perception" icon="eye" href="/api-reference/perception/get-brand-perception">
    Explore scored perception properties.
  </Card>
</CardGroup>