Search by Connector

GET

network

opportunities

by-connector

curl "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"linkedin_url": "https://www.linkedin.com/in/john-doe"},
)

await fetch(
  "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);

{
  "success": true,
  "data": {
    "connector": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "contact": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "opportunities": [
      {
        "opportunity_id": "550e8400-...",
        "prospect": {
          "name": "Jane Smith",
          "job_title": "CTO",
          "company_name": "Acme Corp",
          "positions": [
            {
              "company_name": "Acme Corp",
              "linkedin_numeric_id": "12345678",
              "linkedin_vanity_name": "acme-corp",
              "domain": "acme.com",
              "job_title": "CTO",
              "is_current": true,
                  "is_primary": true
            },
            {
              "company_name": "Northwind Ventures",
              "linkedin_numeric_id": "74364633",
              "linkedin_vanity_name": "northwind-ventures",
              "job_title": "Board member",
              "is_current": true,
                  "is_primary": false
            }
          ]
        },
        "relationship": {
          "confidence_score": 92,
          "total_overlap_months": 58,
          "shared_experience": {
            "company_name": "Microsoft",
            "overlap_months": 36,
            "client_role": "Principal Engineer",
            "prospect_role": "Program Manager",
            "is_current": false,
            "client_location": "Dublin, Ireland",
            "prospect_location": "Redmond, Washington",
            "same_location": false,
            "same_country": false,
            "colleague_label": "different_departments"
          },
          "shared_experience_history": [
            {
              "company_name": "Microsoft",
              "overlap_months": 36,
              "client_role": "Principal Engineer",
              "prospect_role": "Program Manager",
              "is_current": false,
              "client_location": "Dublin, Ireland",
              "prospect_location": "Redmond, Washington",
              "same_location": false,
              "same_country": false,
              "colleague_label": "different_departments"
            },
            {
              "company_name": "Tiny Startup",
              "overlap_months": 22,
              "client_role": "Engineer",
              "prospect_role": "Head of Product",
              "is_current": false,
              "client_location": "Berlin, Germany",
              "prospect_location": "Berlin, Germany",
              "same_location": true,
              "same_country": true,
              "colleague_label": "same_team"
            }
          ],
          "shared_experience_count": 2
        },
        "is_target_company": true
      }
    ],
    "total": 12,
    "page": 1,
    "page_size": 25,
    "has_more": false
  }
}

{
  "success": false,
  "error": {
    "message": "Either linkedin_public_id or linkedin_url is required",
    "code": "BAD_REQUEST"
  }
}

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

Get opportunities for a single connector — one of the people in your network whose connections Clustr analyzes. Provide exactly one of linkedin_public_id or linkedin_url.

This matches the connector side of an opportunity. A person who appears in your network only as a prospect returns 0 opportunities here. To find who can introduce you to a given person, use Search Opportunities with prospect_linkedin_urls.

Renamed. This endpoint was previously /network/search/opportunities/by-contact, and the person in the response was previously called contact. The old path still works and the response still includes a contact field mirroring connector, so existing integrations keep running. New integrations should use connector.

People with several current roles

Plenty of people hold more than one job at a time. A partner at a venture fund may also sit on the boards of three companies the fund backs, and each opportunity is filed under a single one of those companies. Company filters match every role a person currently holds, not just the one their opportunity is filed under, so a search for the fund finds that partner. This needs no parameter and is always on. Past employers are not matched. Someone who left a company is not an opportunity at that company. Add include_all_positions=true to see the full picture in the response: every job each person holds or held, with is_current separating the two and is_primary marking the role the opportunity is filed under.

Query Parameters

string

Connector’s LinkedIn public identifier, e.g. john-doe

string

Connector’s full LinkedIn URL, e.g. https://www.linkedin.com/in/john-doe

boolean

default:"false"

Include engagement history

boolean

default:"false"

Return every job each person holds or held, as a positions array on the person, alongside the single role the opportunity is filed under. Requires a bounded page_size: combining this with the unlimited page returns 400, so page through the results instead.

string

high, mid, low

string

Comma-separated industry names

integer

default:"1"

integer

default:"25"

curl "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"linkedin_url": "https://www.linkedin.com/in/john-doe"},
)

await fetch(
  "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);

{
  "success": true,
  "data": {
    "connector": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "contact": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "opportunities": [
      {
        "opportunity_id": "550e8400-...",
        "prospect": {
          "name": "Jane Smith",
          "job_title": "CTO",
          "company_name": "Acme Corp",
          "positions": [
            {
              "company_name": "Acme Corp",
              "linkedin_numeric_id": "12345678",
              "linkedin_vanity_name": "acme-corp",
              "domain": "acme.com",
              "job_title": "CTO",
              "is_current": true,
                  "is_primary": true
            },
            {
              "company_name": "Northwind Ventures",
              "linkedin_numeric_id": "74364633",
              "linkedin_vanity_name": "northwind-ventures",
              "job_title": "Board member",
              "is_current": true,
                  "is_primary": false
            }
          ]
        },
        "relationship": {
          "confidence_score": 92,
          "total_overlap_months": 58,
          "shared_experience": {
            "company_name": "Microsoft",
            "overlap_months": 36,
            "client_role": "Principal Engineer",
            "prospect_role": "Program Manager",
            "is_current": false,
            "client_location": "Dublin, Ireland",
            "prospect_location": "Redmond, Washington",
            "same_location": false,
            "same_country": false,
            "colleague_label": "different_departments"
          },
          "shared_experience_history": [
            {
              "company_name": "Microsoft",
              "overlap_months": 36,
              "client_role": "Principal Engineer",
              "prospect_role": "Program Manager",
              "is_current": false,
              "client_location": "Dublin, Ireland",
              "prospect_location": "Redmond, Washington",
              "same_location": false,
              "same_country": false,
              "colleague_label": "different_departments"
            },
            {
              "company_name": "Tiny Startup",
              "overlap_months": 22,
              "client_role": "Engineer",
              "prospect_role": "Head of Product",
              "is_current": false,
              "client_location": "Berlin, Germany",
              "prospect_location": "Berlin, Germany",
              "same_location": true,
              "same_country": true,
              "colleague_label": "same_team"
            }
          ],
          "shared_experience_count": 2
        },
        "is_target_company": true
      }
    ],
    "total": 12,
    "page": 1,
    "page_size": 25,
    "has_more": false
  }
}

{
  "success": false,
  "error": {
    "message": "Either linkedin_public_id or linkedin_url is required",
    "code": "BAD_REQUEST"
  }
}

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

curl "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"linkedin_url": "https://www.linkedin.com/in/john-doe"},
)

await fetch(
  "https://api.clustr-ai.com/api/public/network/search/opportunities/by-connector?linkedin_url=https://www.linkedin.com/in/john-doe",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);

{
  "success": true,
  "data": {
    "connector": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "contact": {
      "name": "John Doe",
      "job_title": "Sales Director",
      "company_name": "Your Corp"
    },
    "opportunities": [
      {
        "opportunity_id": "550e8400-...",
        "prospect": {
          "name": "Jane Smith",
          "job_title": "CTO",
          "company_name": "Acme Corp",
          "positions": [
            {
              "company_name": "Acme Corp",
              "linkedin_numeric_id": "12345678",
              "linkedin_vanity_name": "acme-corp",
              "domain": "acme.com",
              "job_title": "CTO",
              "is_current": true,
                  "is_primary": true
            },
            {
              "company_name": "Northwind Ventures",
              "linkedin_numeric_id": "74364633",
              "linkedin_vanity_name": "northwind-ventures",
              "job_title": "Board member",
              "is_current": true,
                  "is_primary": false
            }
          ]
        },
        "relationship": {
          "confidence_score": 92,
          "total_overlap_months": 58,
          "shared_experience": {
            "company_name": "Microsoft",
            "overlap_months": 36,
            "client_role": "Principal Engineer",
            "prospect_role": "Program Manager",
            "is_current": false,
            "client_location": "Dublin, Ireland",
            "prospect_location": "Redmond, Washington",
            "same_location": false,
            "same_country": false,
            "colleague_label": "different_departments"
          },
          "shared_experience_history": [
            {
              "company_name": "Microsoft",
              "overlap_months": 36,
              "client_role": "Principal Engineer",
              "prospect_role": "Program Manager",
              "is_current": false,
              "client_location": "Dublin, Ireland",
              "prospect_location": "Redmond, Washington",
              "same_location": false,
              "same_country": false,
              "colleague_label": "different_departments"
            },
            {
              "company_name": "Tiny Startup",
              "overlap_months": 22,
              "client_role": "Engineer",
              "prospect_role": "Head of Product",
              "is_current": false,
              "client_location": "Berlin, Germany",
              "prospect_location": "Berlin, Germany",
              "same_location": true,
              "same_country": true,
              "colleague_label": "same_team"
            }
          ],
          "shared_experience_count": 2
        },
        "is_target_company": true
      }
    ],
    "total": 12,
    "page": 1,
    "page_size": 25,
    "has_more": false
  }
}

{
  "success": false,
  "error": {
    "message": "Either linkedin_public_id or linkedin_url is required",
    "code": "BAD_REQUEST"
  }
}

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

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Target Accounts

ICP

Competitor Monitoring

Search by Connector

People with several current roles

Query Parameters

​People with several current roles

​Query Parameters

People with several current roles

Query Parameters