Skip to main content
GET
List connectors (people) in your network. Connectors are the people you’ve imported whose LinkedIn connections are analyzed for referral opportunities.

Owners

clustr_owner_id, owner_id, owner_email and owner_name are present only when a teammate owns the connector. Connectors with no owner omit them all, and you can list exactly those with ?owner_email=unassigned. Set it at import time with owner_email on Import Connectors, or at any time afterwards with Set Connector Owner. To find teammates who have not contributed any connectors yet, call List Owners with with_counts=true and look for an opportunity_count of 0.

Authorizations

Authorization
string
header
required

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

Query Parameters

Keep connectors whose name contains this text.

connector_tag
string

Keep connectors with this tag, for example Employee or Friend.

account_tag
string

Account tag ids, from List Tags with subject_type=account: keeps connectors whose current company's account carries them. Repeat the parameter or send a comma-separated list. Several ids match a connector carrying any of them.

path_tag
string

Warm intro tag ids (GET /tag-groups, subject type path), comma-separated or repeated: keeps connectors with at least one warm intro carrying them. Several ids match a connector with warm intros carrying any of them.

owner_email
string[]

Filter by owner: an email address (the same one you send as owner_email when importing) or an owner's Clustr ID (own_…) from List Owners. Repeat the parameter or comma-separate several values. Pass unassigned for connectors nobody owns. A value that matches no owner returns an empty page. It takes the same values as the owners filter on Search Opportunities.

page
integer
default:1

The page to return, starting at 1.

page_size
integer
default:25

How many results to return per page.

Response

List of connectors

success
boolean
required
data
object
required