Skip to content

Docs / All tools / Loop IV: Validation

problem.mine

Find complaints in a market and rank them by the number of people who mention them. The scan runs in the background and returns evidence links.

800 credits. Per scan. 0 when the scan finds no problem.

Example prompt

Send this to your AI app when Heelo is connected:

Find the most common complaints of Shopify store owners about their analytics, with links to the posts.

Input fields

FieldTypeDescription
action"scan" | "result"
domainstringThe topic area to mine, e.g. 'tools for indie developers'
querystringFree text from ReAct or MCP: naming a job id reads that scan, else it is the domain
sourcesarray of stringSome of github_issues, hacker_news, web_pages, app_pages, forums, reddit; default github_issues, hacker_news, web_pages, app_pages, forums, reddit.
window_daysinteger
min_mentionsintegerMinimum distinct authors per problem
job_idstring

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/problem.mine/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "domain": "analytics for Shopify store owners",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())