Register Competitor

curl -X POST https://api.clustr-ai.com/api/public/competitors \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Globex Inc",
    "domain": "globex.com",
    "linkedin_url": "https://www.linkedin.com/company/globex"
  }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitors",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "company_name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex",
    },
)

await fetch("https://api.clustr-ai.com/api/public/competitors", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    company_name: "Globex Inc",
    domain: "globex.com",
    linkedin_url: "https://www.linkedin.com/company/globex",
  }),
});

{
  "success": true,
  "data": {
    "competitor": {
      "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"
    },
    "slot_usage": { "used": 3, "active": 3, "limit": 5 }
  }
}

{
  "success": false,
  "error": {
    "message": "Competitor monitoring slot limit reached",
    "code": "CONFLICT"
  }
}

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