List All Competitor Customers

GET

competitor-customers

curl "https://api.clustr-ai.com/api/public/competitor-customers?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-customers",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 50},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-customers?limit=50", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "customers": [
      {
        "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
        "clustr_account_id": "acc_g756rvkxxsbt7wedcdh3rsqvyb",
        "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
        "competitor": {
          "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "name": "Globex"
        },
        "company_name": "Initech",
        "domain": "initech.com",
        "linkedin_numeric_id": "1035",
        "company_id": "3f9a1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
        "label": "likely",
        "score": 50,
        "signals": [
          { "signal": "logo_wall", "weight": 50, "url": "https://globex.com/", "count": 1 }
        ],
        "contacts": [],
        "possible_churn": false,
        "renewal_date": "2027-03-31",
        "renewal_task_created_at": null,
        "confidence": "named",
        "sources": ["logo_wall"],
        "first_seen_at": "2026-09-07T06:00:00Z",
        "last_seen_at": "2026-10-05T06:00:00Z",
        "removed_at": null,
        "renewal_window_start": null,
        "renewal_window_end": null,
        "user_verdict": "confirmed",
        "in_crm": true,
        "is_customer_of_ours": false,
        "evidence": [
          {
            "kind": "logo_wall",
            "signal": "logo_wall",
            "weight": 50,
            "url": "https://globex.com/",
            "quote": null,
            "person_name": null,
            "person_title": null,
            "observed_at": "2026-09-07T06:00:00Z"
          }
        ]
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

The customers of every competitor you track, in one list. Each row is the same as in List Competitor Customers, plus a competitor object naming whose customer it is. Pass competitor_id to narrow the list to one competitor, owner to keep one CRM owner’s, and order=standing to list your own customers first. Confirmed and likely customers by default; see List Competitor Customers for the signals and labels.

curl "https://api.clustr-ai.com/api/public/competitor-customers?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-customers",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 50},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-customers?limit=50", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "customers": [
      {
        "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
        "clustr_account_id": "acc_g756rvkxxsbt7wedcdh3rsqvyb",
        "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
        "competitor": {
          "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "name": "Globex"
        },
        "company_name": "Initech",
        "domain": "initech.com",
        "linkedin_numeric_id": "1035",
        "company_id": "3f9a1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
        "label": "likely",
        "score": 50,
        "signals": [
          { "signal": "logo_wall", "weight": 50, "url": "https://globex.com/", "count": 1 }
        ],
        "contacts": [],
        "possible_churn": false,
        "renewal_date": "2027-03-31",
        "renewal_task_created_at": null,
        "confidence": "named",
        "sources": ["logo_wall"],
        "first_seen_at": "2026-09-07T06:00:00Z",
        "last_seen_at": "2026-10-05T06:00:00Z",
        "removed_at": null,
        "renewal_window_start": null,
        "renewal_window_end": null,
        "user_verdict": "confirmed",
        "in_crm": true,
        "is_customer_of_ours": false,
        "evidence": [
          {
            "kind": "logo_wall",
            "signal": "logo_wall",
            "weight": 50,
            "url": "https://globex.com/",
            "quote": null,
            "person_name": null,
            "person_title": null,
            "observed_at": "2026-09-07T06:00:00Z"
          }
        ]
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Query Parameters

company

string

Keeps the customers at this company, by its name. Repeat it for several companies (a name may hold a comma, so it is never split).

competitor_id

string

Only this competitor's customers, by its Clustr ID (cmp_…). The id from earlier responses also works.

label

string

Keeps the customers with these labels, as a comma-separated list of confirmed, likely and possible. Defaults to confirmed,likely. possible also needs include_possible.

include_possible

enum<string>

true also lists possible customers, the ones with only a weak signal.

Available options:

0,

1,

true,

false

signal

string

Keeps the customers with at least one of these signals, as a comma-separated list: case_study, testimonial, post_announcement, post_webinar, post_highlight, logo_wall, cs_interaction or product_user_comment.

include_rejected

enum<string>

Set to 1 to also list the customers you rejected.

Available options:

0,

1

order

enum<string>

standing lists your own customers first, then the companies in your CRM, then the rest in the default order.

Available options:

standing

owner

string

Keeps the customers whose CRM account owner or CS owner has this email address. Customers are matched to your CRM on their domain.

cs_owner

string

Keeps the customers whose CS owner has this email address: the CS owner set in Clustr, or else the one in your CRM.

limit

integer

default:100

The number of customers per page, at most 500.

Required range: x <= 500

offset

integer

default:0

The number of customers to skip, for paging.

Response

One page of customers

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl "https://api.clustr-ai.com/api/public/competitor-customers?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-customers",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 50},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-customers?limit=50", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "customers": [
      {
        "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
        "clustr_account_id": "acc_g756rvkxxsbt7wedcdh3rsqvyb",
        "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
        "competitor": {
          "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "name": "Globex"
        },
        "company_name": "Initech",
        "domain": "initech.com",
        "linkedin_numeric_id": "1035",
        "company_id": "3f9a1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
        "label": "likely",
        "score": 50,
        "signals": [
          { "signal": "logo_wall", "weight": 50, "url": "https://globex.com/", "count": 1 }
        ],
        "contacts": [],
        "possible_churn": false,
        "renewal_date": "2027-03-31",
        "renewal_task_created_at": null,
        "confidence": "named",
        "sources": ["logo_wall"],
        "first_seen_at": "2026-09-07T06:00:00Z",
        "last_seen_at": "2026-10-05T06:00:00Z",
        "removed_at": null,
        "renewal_window_start": null,
        "renewal_window_end": null,
        "user_verdict": "confirmed",
        "in_crm": true,
        "is_customer_of_ours": false,
        "evidence": [
          {
            "kind": "logo_wall",
            "signal": "logo_wall",
            "weight": 50,
            "url": "https://globex.com/",
            "quote": null,
            "person_name": null,
            "person_title": null,
            "observed_at": "2026-09-07T06:00:00Z"
          }
        ]
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

List All Competitor Customers

Authorizations

Query Parameters

Response