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
| Field | Type | Description |
|---|---|---|
query | string | The ICP in plain language, e.g. 'seed-stage fintech startups in the US' |
spec | object | Structured ICP criteria; merged over anything parsed from `query` |
session_id | string | Continue an in-progress ICP definition conversation |
message | string | Answer to the previous clarification question |
target_count | integer | How many companies to return (default 10) |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
job_id | string |
status | string |
spec | object |
target_count | integer |
reused_existing_job | boolean |
poll_with | string |
answer | string |
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())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/icp.search/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"query": "Find seed-stage fintech startups in the US and who to contact there"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());