Skip to content

Docs / All tools / Loop II: Acquisition

demand.radar

Find people discussing a specific pain point on the public web. Return one entry per person, with direct quotes, sources, and a 30-day trend.

90 credits. Per search or job that finds at least one person. Reading a result is free.

Example prompt

Send this to your AI app when Heelo is connected:

Find people who complain that onboarding developers to a new API takes too long. Give me their words and the links.

Input fields

FieldTypeDescription
action"search" | "start" | "result"
painstring
job_idstring
platformsarray of stringWhere to search: reddit, bluesky (a connected account), twitter (a connected browser session), web, github (public issues, through GitHub's search API) and hackernews (stories and comments, through the Hacker News Search API). LinkedIn is refused.
window_daysinteger
min_signalinteger
max_peopleinteger
exclude_domainsarray of 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/demand.radar/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "pain": "onboarding developers to a new API takes too long",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())