Search Opportunities

GET

network

opportunities

curl "https://api.clustr-ai.com/api/public/network/search/opportunities?domains=acme.com&confidence_ranges=80-100&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "results": [
      {
        "client": {
          "name": "John Doe",
          "job_title": "Sales Director",
          "owner_email": "alice@company.com",
          "owner_name": "Alice Martin"
        },
        "opportunities": [
          {
            "opportunity_id": "opp_abc123",
            "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": 36 },
            "is_target_company": true
          }
        ]
      }
    ],
    "total": 42,
    "page": 1,
    "page_size": 25,
    "has_more": true
  }
}

Search opportunities with optional filters. All parameters are optional. Call with no filters to list all opportunities, or combine filters to narrow results. To search for a specific connector’s opportunities, use the /by-connector variant: GET /network/search/opportunities/by-connector?linkedin_public_id=john-doe. To find who can introduce you to a specific prospect, filter this endpoint by prospect_linkedin_urls instead: GET /network/search/opportunities?prospect_linkedin_urls=https://www.linkedin.com/in/jane-smith. The /by-connector variant matches the connector side only and will return 0 results for a prospect.

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.

Who to ask for the introduction

Each client (the connector) carries owner_email and owner_name: the team member who owns that connector, and therefore the person to ask. Both are omitted when the connector has no owner, so absence means unowned rather than unknown. They are returned here so you do not have to resolve them yourself. Paging /network/connectors to build an owner map costs one request per 100 connectors, which becomes the slowest part of a sidepanel once a network passes a few hundred connectors.

Query Parameters

Company filters

string

Comma-separated company domains (e.g. acme.com,stripe.com)

string

Comma-separated company LinkedIn URLs

string

Comma-separated LinkedIn numeric IDs

string

Comma-separated LinkedIn vanity names

Client/prospect filters

string

Comma-separated client (connector) names

string

Comma-separated client LinkedIn URLs

string

Comma-separated client LinkedIn public identifiers

string

Comma-separated client company names

string

Comma-separated prospect names

string

Comma-separated prospect LinkedIn URLs

string

Comma-separated prospect job titles

string

Comma-separated prospect company names

string

Comma-separated owners, each either an owner UUID from List Owners or an owner email address. Addresses are matched case-insensitively; one that belongs to no owner simply matches nothing.

Scoring and engagement filters

string

high, mid, low

string

Comma-separated industry names

string

Comma-separated country names

string

e.g. 80-100,60-79

string

Comma-separated employee count ranges (e.g. 51-200,501-1000)

string

Comma-separated revenue ranges

string

Comma-separated opportunity statuses

string

Comma-separated engagement types

string

Comma-separated CRM statuses

Date and behavior filters

string

Filter by creation date (YYYY-MM-DD)

string

Filter by creation date (YYYY-MM-DD)

boolean

default:"false"

Exclude prospects at the same company as the client

boolean

default:"false"

Include opportunities with no engagement

boolean

default:"false"

Include full engagement history

boolean

default:"false"

Bypass cache and fetch fresh results

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

Filter by import job ID

Pagination

integer

default:"1"

integer

default:"25"

string

curl "https://api.clustr-ai.com/api/public/network/search/opportunities?domains=acme.com&confidence_ranges=80-100&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "results": [
      {
        "client": {
          "name": "John Doe",
          "job_title": "Sales Director",
          "owner_email": "alice@company.com",
          "owner_name": "Alice Martin"
        },
        "opportunities": [
          {
            "opportunity_id": "opp_abc123",
            "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": 36 },
            "is_target_company": true
          }
        ]
      }
    ],
    "total": 42,
    "page": 1,
    "page_size": 25,
    "has_more": true
  }
}

curl "https://api.clustr-ai.com/api/public/network/search/opportunities?domains=acme.com&confidence_ranges=80-100&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "results": [
      {
        "client": {
          "name": "John Doe",
          "job_title": "Sales Director",
          "owner_email": "alice@company.com",
          "owner_name": "Alice Martin"
        },
        "opportunities": [
          {
            "opportunity_id": "opp_abc123",
            "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": 36 },
            "is_target_company": true
          }
        ]
      }
    ],
    "total": 42,
    "page": 1,
    "page_size": 25,
    "has_more": true
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Target Accounts

ICP

Competitor Monitoring

Search Opportunities

People with several current roles

Who to ask for the introduction

Query Parameters

Company filters

Client/prospect filters

Scoring and engagement filters

Date and behavior filters

​People with several current roles

​Who to ask for the introduction

​Query Parameters

​Company filters

​Client/prospect filters

​Scoring and engagement filters

​Date and behavior filters

​Pagination

People with several current roles

Who to ask for the introduction

Query Parameters

Company filters

Client/prospect filters

Scoring and engagement filters

Date and behavior filters

Pagination