trends. signals
Collect trending topics and keyword signals from social platforms and search.
2 credits. Per call. 0 when no signal is found.
Example prompt
Send this to your AI app when Heelo is connected:
Find today's trending keywords across Google, X, TikTok, Instagram, Threads, and Facebook
Input fields
| Field | Type | Description |
|---|---|---|
query | string | Natural-language request, e.g. 'find today's AI trend keywords across TikTok and X'. |
topic | string | Optional explicit topic or industry scope. Overrides the LLM plan when provided. |
platforms | array of string | Platforms to scan: google, x, tiktok, facebook, instagram, threads, reddit, linkedin. |
region | string | Two-letter Google region code, e.g. us, gb, ca. |
time_window | string | Recency window: day, week, or month. |
max_keywords | integer | Maximum ranked keywords to return. |
max_results_per_platform | integer | Search results per platform. |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
report | object |
keywords | array of object |
platform_signals | array of object |
queries | object |
platforms_scanned | array of string |
time_window | string |
region | 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/trends.signals/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {}},
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/trends.signals/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());