> ## 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.

# Get Competitor Account

> One account, per competitor, with 30 and 90 day interactions, salespeople, last interaction, weekly series

Which competitors are working one account, and how. For each competitor:

* `interactions_30d` and `interactions_90d`: interactions in every direction (their salespeople liking or commenting on people at the account, and people at the account liking or commenting on their salespeople's posts);
* `reps`: the salespeople involved, with how many interactions each had in 90 days;
* `last_interaction_at`;
* `weekly`: 13 weeks of counts, oldest first and this week last, so you can see whether it recurs.

`use_case` is `defense` when the account is your customer (on your client list, or a customer in your CRM) and `attack` otherwise. At your customers everyone counts, whatever their title; at every other account only people who match your [buyer titles](https://docs.clustr-ai.com/buyer-titles.md) count. [Ignored](https://docs.clustr-ai.com/api-reference/ignore-competitor-interaction.md) interactions do not.

For the interactions themselves, see [account interactions](https://docs.clustr-ai.com/api-reference/list-account-competitor-interactions.md).

```bash cURL theme={null}
curl https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c \
  -H "Authorization: Bearer YOUR_API_KEY"
```

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

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

```javascript JavaScript theme={null}
await fetch("https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
    "account_id": "1553894",
    "company_name": "Northwind Trading",
    "company_domain": "northwind.com",
    "is_customer": true,
    "use_case": "defense",
    "interactions_30d": 6,
    "interactions_90d": 14,
    "last_interaction_at": "2026-10-02T09:41:00Z",
    "by_competitor": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex/",
        "interactions_30d": 6,
        "interactions_90d": 14,
        "reps": [
          {
            "clustr_person_id": "per_x3mj8hbn822n1xybc73f80s3em",
            "linkedin_id": "sam-globex",
            "name": "Sam Carter",
            "title": "Account Executive at Globex",
            "linkedin_url": "https://www.linkedin.com/in/sam-globex/",
            "count": 9,
            "last_interaction_at": "2026-10-02T09:41:00Z"
          }
        ],
        "last_interaction_at": "2026-10-02T09:41:00Z",
        "weekly": [
          { "week": "2026-07-13", "interactions": 0 },
          { "week": "2026-07-20", "interactions": 1 },
          { "week": "2026-10-05", "interactions": 2 }
        ]
      }
    ]
  }
}
```


## OpenAPI

````yaml GET /competitor-accounts/{accountID}
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-accounts/{accountID}:
    get:
      tags:
        - Competitor Monitoring
      summary: Get Competitor Account
      description: >
        One account's competitor picture: whether it is your customer (Defense)
        or not

        (Attack), and per competitor the interactions over 30 and 90 days, the

        salespeople involved, the last interaction and a 13-week series.
      operationId: getCompetitorAccount
      parameters:
        - name: accountID
          in: path
          required: true
          description: >-
            The account's Clustr ID (`acc_…`). Its LinkedIn numeric company id,
            the `company_numeric_id`

            that [List Competitor
            Accounts](/api-reference/list-competitor-accounts) returns, also
            works.
          schema:
            type: string
          example: acc_kqmp266311aa1ace52g72vxxhj
      responses:
        '200':
          description: The account's competitors
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    additionalProperties: true
        '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:
    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.