Export Competitor Interactions

GET

competitor-interactions

export

curl --compressed "https://api.clustr-ai.com/api/public/competitor-interactions/export" \
  -H "Authorization: Bearer YOUR_API_KEY"

# The same rows as a CSV file
curl --compressed -OJ "https://api.clustr-ai.com/api/public/competitor-interactions/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/export",
    params={"format": "csv"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=180,
)
if resp.headers["X-Export-Truncated"] == "true":
    print(f"First {resp.headers['X-Export-Rows']} of {resp.headers['X-Export-Total']} interactions")
with open("competitor-interactions.csv", "wb") as f:
    f.write(resp.content)

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/export",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();
if (data.truncated) {
  console.log(`First ${data.interactions.length} of ${data.total} interactions`);
}

{
  "success": true,
  "data": {
    "interactions": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "competitor_domain": "globex.com",
        "rep_name": "Samir Khoury",
        "rep_title": "Enterprise AE",
        "target_name": "Dana Patel",
        "target_company_name": "Northwind Trading",
        "interaction_type": "comment",
        "engagement_at": "2026-07-28T14:02:11Z",
        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7212345678901234567"
      }
    ],
    "total": 4128,
    "truncated": false
  }
}

Your workspace’s entire competitor-interaction history, in one response, for analysis outside Clustr. It returns the whole history in one response, deliberately unfiltered and unpaged: the result means the same thing every time it is called, regardless of how anyone had the app’s table narrowed. The exclusions that are properties of the data rather than of a view still apply (dismissed people, the competitor’s own staff, and advisory/investor targets), and duplicates are merged on (actor, target, type, post), so there is one row per real interaction. Sorted newest-first.

This is a bulk export and can be large and slow. If you want a subset, use the filtered feed with a from/to window instead.

The deal fields (has_open_deal, deal_name, deal_stage, deal_amount) are the account’s open deal in your CRM, the one the Accounts page shows, read when you export. They are empty when the account has no open deal.

JSON or CSV

By default the response is JSON (the example on the right). Add format=csv to get the same rows as a CSV file instead, the one the app’s Export button downloads:

UTF-8 with a byte order mark, so Excel reads accented names correctly.
Sent as an attachment named clustr-competitor-interactions-<YYYY-MM-DD>.csv (the date in UTC).
A cell that starts with =, +, - or @ gets a leading apostrophe, so a spreadsheet never runs it as a formula.

Any other format value is answered with a 400.

At most 50,000 rows

One export holds at most 50,000 interactions, the newest ones. Every response, JSON or CSV, says how big it is in three headers:

Header	Meaning
`X-Export-Total`	Interactions in your history.
`X-Export-Rows`	Interactions in this response.
`X-Export-Truncated`	`true` when your history held more than this response does.

In JSON, data.total and data.truncated say the same. When it is truncated, say so rather than silently hand on a short file. The rows are sent as they are read, so the first bytes arrive before the last row is ready. If an export fails partway, the connection is closed before the response ends, and a CSV ends with the line # EXPORT FAILED: this file is incomplete. Download it again. A response that ends normally is complete.

Compression

Send Accept-Encoding: gzip (most HTTP clients do by default) and the response is gzip-compressed, typically several times smaller.

curl --compressed "https://api.clustr-ai.com/api/public/competitor-interactions/export" \
  -H "Authorization: Bearer YOUR_API_KEY"

# The same rows as a CSV file
curl --compressed -OJ "https://api.clustr-ai.com/api/public/competitor-interactions/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/export",
    params={"format": "csv"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=180,
)
if resp.headers["X-Export-Truncated"] == "true":
    print(f"First {resp.headers['X-Export-Rows']} of {resp.headers['X-Export-Total']} interactions")
with open("competitor-interactions.csv", "wb") as f:
    f.write(resp.content)

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/export",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();
if (data.truncated) {
  console.log(`First ${data.interactions.length} of ${data.total} interactions`);
}

{
  "success": true,
  "data": {
    "interactions": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "competitor_domain": "globex.com",
        "rep_name": "Samir Khoury",
        "rep_title": "Enterprise AE",
        "target_name": "Dana Patel",
        "target_company_name": "Northwind Trading",
        "interaction_type": "comment",
        "engagement_at": "2026-07-28T14:02:11Z",
        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7212345678901234567"
      }
    ],
    "total": 4128,
    "truncated": false
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

format

enum<string>

default:json

json (the default) or csv. CSV is UTF-8 with a byte order mark, served as an attachment named clustr-competitor-interactions-<YYYY-MM-DD>.csv; a cell that starts with = + - @ gets a leading apostrophe so a spreadsheet reads it as text. Any other value answers 400.

Available options:

json,

csv

Response

The whole interaction history

The CSV file, when format=csv.

curl --compressed "https://api.clustr-ai.com/api/public/competitor-interactions/export" \
  -H "Authorization: Bearer YOUR_API_KEY"

# The same rows as a CSV file
curl --compressed -OJ "https://api.clustr-ai.com/api/public/competitor-interactions/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/export",
    params={"format": "csv"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=180,
)
if resp.headers["X-Export-Truncated"] == "true":
    print(f"First {resp.headers['X-Export-Rows']} of {resp.headers['X-Export-Total']} interactions")
with open("competitor-interactions.csv", "wb") as f:
    f.write(resp.content)

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/export",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();
if (data.truncated) {
  console.log(`First ${data.interactions.length} of ${data.total} interactions`);
}

{
  "success": true,
  "data": {
    "interactions": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "competitor_domain": "globex.com",
        "rep_name": "Samir Khoury",
        "rep_title": "Enterprise AE",
        "target_name": "Dana Patel",
        "target_company_name": "Northwind Trading",
        "interaction_type": "comment",
        "engagement_at": "2026-07-28T14:02:11Z",
        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7212345678901234567"
      }
    ],
    "total": 4128,
    "truncated": false
  }
}

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

Export Competitor Interactions

JSON or CSV

At most 50,000 rows

Compression

Authorizations

Query Parameters

Response

​JSON or CSV

​At most 50,000 rows

​Compression

Authorizations

Query Parameters

Response

JSON or CSV

At most 50,000 rows

Compression