List Target Accounts

GET

target-accounts

curl "https://api.clustr-ai.com/api/public/target-accounts" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

await fetch("https://api.clustr-ai.com/api/public/target-accounts", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "target_accounts": [
      {
        "clustr_target_account_id": "tacc_jybe005qdjmzf6wfzat2qwfr4m",
        "clustr_tier_id": "tier_e0zk0smsdyw6sb6qnvm93enef4",
        "clustr_account_id": "acc_jebpt1d3egm3196vqqm8c5s1fb",
        "id": "a1b2c3d4-...",
        "account_name": "Acme Corp",
        "account_linkedin_url": "https://www.linkedin.com/company/acme-corp",
        "tier": "Tier 1",
        "tier_id": "7f3e1a22-...",
        "company_id": "9c4d5e6f-..."
      }
    ],
    "count": 1
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

{
  "success": false,
  "error": {
    "message": "Target account not found",
    "code": "NOT_FOUND"
  }
}

Returns all target accounts, or search by ID, name, or LinkedIn URL.

Response fields

Alongside the name and URL, each row carries:

Field	Meaning
`tier`	The tier this account is filed under, named the way your workspace names it. Empty means untiered
`tier_id`	That tier’s id, for writing it back exactly
`company_id`	The company this account matched. Empty means it matched none, which is why such an account cannot be tiered yet, and the fix is to add or correct its LinkedIn URL
`linkedin_lookup`	`not_found` when the LinkedIn company page given for this account could not be found after two lookups, a week apart. It may be a wrong or outdated URL: check it. Meanwhile the account is matched by its name when exactly one company carries that name. Omitted otherwise, and gone as soon as the URL is changed

An account whose LinkedIn page Clustr does not know yet is looked up for you in the background: at most twice per page, a week apart. A page found then is matched without anything to do on your side.

A tier belongs to the company behind the account, so the same tier appears on the Accounts and People tables in the app. There is one tier per account, not one per surface.

curl "https://api.clustr-ai.com/api/public/target-accounts" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

await fetch("https://api.clustr-ai.com/api/public/target-accounts", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "target_accounts": [
      {
        "clustr_target_account_id": "tacc_jybe005qdjmzf6wfzat2qwfr4m",
        "clustr_tier_id": "tier_e0zk0smsdyw6sb6qnvm93enef4",
        "clustr_account_id": "acc_jebpt1d3egm3196vqqm8c5s1fb",
        "id": "a1b2c3d4-...",
        "account_name": "Acme Corp",
        "account_linkedin_url": "https://www.linkedin.com/company/acme-corp",
        "tier": "Tier 1",
        "tier_id": "7f3e1a22-...",
        "company_id": "9c4d5e6f-..."
      }
    ],
    "count": 1
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

{
  "success": false,
  "error": {
    "message": "Target account not found",
    "code": "NOT_FOUND"
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

string

The target account's Clustr ID (tacc_…). The response then holds that one account. The id from earlier responses also works.

string

Keep the accounts whose name contains this text.

linkedin_url

string

Find the account with this LinkedIn URL.

page

integer

default:1

The page to return. Sending page or page_size pages the list.

Required range: x >= 1

page_size

integer

default:25

Accounts per page. Defaults to 25, up to 500.

Required range: 1 <= x <= 500

Response

Target accounts list

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl "https://api.clustr-ai.com/api/public/target-accounts" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

await fetch("https://api.clustr-ai.com/api/public/target-accounts", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "target_accounts": [
      {
        "clustr_target_account_id": "tacc_jybe005qdjmzf6wfzat2qwfr4m",
        "clustr_tier_id": "tier_e0zk0smsdyw6sb6qnvm93enef4",
        "clustr_account_id": "acc_jebpt1d3egm3196vqqm8c5s1fb",
        "id": "a1b2c3d4-...",
        "account_name": "Acme Corp",
        "account_linkedin_url": "https://www.linkedin.com/company/acme-corp",
        "tier": "Tier 1",
        "tier_id": "7f3e1a22-...",
        "company_id": "9c4d5e6f-..."
      }
    ],
    "count": 1
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

{
  "success": false,
  "error": {
    "message": "Target account not found",
    "code": "NOT_FOUND"
  }
}

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 Target Accounts

Response fields

Authorizations

Query Parameters

Response

​Response fields

Authorizations

Query Parameters

Response

Response fields