List Competitors

curl https://api.clustr-ai.com/api/public/competitors \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitors",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "competitors": [
      {
        "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "company_name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex",
        "status": "active",
        "created_at": "2026-06-30T09:00:00Z",
        "updated_at": "2026-06-30T09:00:00Z"
      },
      {
        "id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
        "company_name": "Initech",
        "domain": "initech.com",
        "linkedin_url": "https://www.linkedin.com/company/initech",
        "status": "paused",
        "created_at": "2026-06-20T11:30:00Z",
        "updated_at": "2026-06-28T08:15:00Z"
      }
    ],
    "slot_usage": { "used": 1, "active": 1, "limit": 5 }
  }
}

{
  "success": false,
  "error": {
    "message": "Competitor monitoring is not enabled for this tenant",
    "code": "FORBIDDEN"
  }
}