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

# Look Up Competitor Customers by Company

> Which competitors each of your companies buys from

For each company you name, the competitors it is a `confirmed` or `likely` customer of, with
the label and any renewal date you set. Companies that are no competitor's customer are left
out. Possible customers, customers you rejected, and customers whose evidence disappeared do
not count. `renewal_window_start` and `renewal_window_end` are always `null`.

```bash cURL theme={null}
curl "https://api.clustr-ai.com/api/public/competitor-customers/by-company?company_ids=acc_g756rvkxxsbt7wedcdh3rsqvyb,acc_zy282j7xeqfjfaqc5nny5ftv60" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

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

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-customers/by-company",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"company_ids": "acc_g756rvkxxsbt7wedcdh3rsqvyb,acc_zy282j7xeqfjfaqc5nny5ftv60"},
)
```

```javascript JavaScript theme={null}
await fetch(
  "https://api.clustr-ai.com/api/public/competitor-customers/by-company?company_ids=acc_g756rvkxxsbt7wedcdh3rsqvyb,acc_zy282j7xeqfjfaqc5nny5ftv60",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
```

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "clustr_account_id": "acc_g756rvkxxsbt7wedcdh3rsqvyb",
      "company_id": "3f9a1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
      "competitors": [
        {
          "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "name": "Globex",
          "renewal_window_start": null,
          "renewal_window_end": null,
          "renewal_date": "2027-03-31",
          "label": "confirmed",
          "score": 100,
          "confidence": "quoted"
        }
      ]
    }
  ]
}
```


## OpenAPI

````yaml GET /competitor-customers/by-company
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /competitor-customers/by-company:
    get:
      tags:
        - Competitor Monitoring
      summary: Look Up Competitor Customers by Company
      description: >-
        For each company you name, returns the competitors it is a confirmed or
        likely customer of, with the label. Only confirmed and likely customers
        count, and the answer lists only the companies that are a customer of at
        least one competitor.
      operationId: listCompetitorCustomersByCompany
      parameters:
        - name: company_ids
          in: query
          required: true
          description: >-
            The accounts' Clustr IDs (`acc_…`), comma-separated, at most 500.
            Company ids and LinkedIn

            numeric company ids also work. Each answer carries the account's
            `clustr_account_id`.
          schema:
            type: string
          example: acc_x1pqtb7399698qwjmvcbpewfqs
      responses:
        '200':
          description: One entry per company that is a competitor's customer
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompetitorCustomersByCompany'
        '400':
          description: A company id is invalid, or more than 500 were sent
        '401':
          description: Invalid or missing API key
        '403':
          description: Competitor monitoring is not enabled for this workspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    CompetitorCustomersByCompany:
      type: object
      properties:
        clustr_account_id:
          type: string
          description: >-
            The account's Clustr ID, for example
            `acc_4faj24ew89cqwv16k9fkfyp2jr`.
          example: acc_4faj24ew89cqwv16k9fkfyp2jr
        company_id:
          type: string
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_account_id`.
        competitors:
          type: array
          items:
            type: object
            properties:
              clustr_competitor_id:
                type: string
                description: >-
                  The competitor's Clustr ID, for example
                  `cmp_2mtwgg21kg3kverv3whkjkqn8y`. Use it to refer to

                  this competitor.
                example: cmp_2mtwgg21kg3kverv3whkjkqn8y
              id:
                type: string
                description: >-
                  Kept for integrations built before Clustr IDs. New
                  integrations should use `clustr_competitor_id`.
              name:
                type: string
              renewal_window_start:
                type: string
                format: date
                nullable: true
              renewal_window_end:
                type: string
                format: date
                nullable: true
              renewal_date:
                type: string
                format: date
                nullable: true
              label:
                type: string
                enum:
                  - confirmed
                  - likely
              score:
                type: integer
              confidence:
                type: string
                enum:
                  - quoted
                  - named
                  - company_only
                  - inferred
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            message:
              type: string
              example: Invalid request body
            code:
              type: string
              example: BAD_REQUEST
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.