Skip to content

Docs / All tools / Loop II: Acquisition

icp.search

Find companies that match an ideal customer profile. The job runs in the background and returns company, funding, and contact information.

6 credits. Per company returned.

Example prompt

Send this to your AI app when Heelo is connected:

Find seed-stage fintech startups in the US and who to contact there

Input fields

FieldTypeDescription
querystringThe ICP in plain language, e.g. 'seed-stage fintech startups in the US'
specobjectStructured ICP criteria; merged over anything parsed from `query`
session_idstringContinue an in-progress ICP definition conversation
messagestringAnswer to the previous clarification question
target_countintegerHow many companies to return (default 10)

Output fields

The fields in data when status is success.

FieldType
job_idstring
statusstring
specobject
target_countinteger
reused_existing_jobboolean
poll_withstring
answerstring

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/icp.search/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "Find seed-stage fintech startups in the US and who to contact there",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())