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

# List Competitors

Get all competitors for the business. Returns a lightweight list suitable for rendering competitor bubbles in the Explore tab.

## Example Request

```bash theme={null}
curl -X GET https://searchcompany-main.up.railway.app/api/explore/competitors \
  -H "Authorization: Bearer $TOKEN"
```

## Example Response

```json theme={null}
{
  "status": "success",
  "competitors": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Nike",
      "url": "https://nike.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/abc123.png",
      "source": "auto_discovered"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Adidas",
      "url": "https://adidas.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/def456.png",
      "source": "auto_discovered"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Lululemon",
      "url": "https://lululemon.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/ghi789.png",
      "source": "user_added"
    }
  ],
  "count": 3
}
```

## Response Fields

| Field         | Type   | Description                  |
| ------------- | ------ | ---------------------------- |
| `status`      | string | `"success"`                  |
| `competitors` | array  | List of competitor summaries |
| `count`       | number | Total number of competitors  |

### Competitor Summary Fields

| Field         | Type   | Description                           |
| ------------- | ------ | ------------------------------------- |
| `id`          | string | Unique competitor ID (UUID)           |
| `name`        | string | Company name                          |
| `url`         | string | Company website URL                   |
| `favicon_url` | string | URL to company favicon                |
| `source`      | string | `"auto_discovered"` or `"user_added"` |