Skip to content

Docs / All tools / Base tools

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

FieldTypeDescription
querystringNatural-language request, e.g. 'find today's AI trend keywords across TikTok and X'.
topicstringOptional explicit topic or industry scope. Overrides the LLM plan when provided.
platformsarray of stringPlatforms to scan: google, x, tiktok, facebook, instagram, threads, reddit, linkedin.
regionstringTwo-letter Google region code, e.g. us, gb, ca.
time_windowstringRecency window: day, week, or month.
max_keywordsintegerMaximum ranked keywords to return.
max_results_per_platformintegerSearch results per platform.

Output fields

The fields in data when status is success.

FieldType
reportobject
keywordsarray of object
platform_signalsarray of object
queriesobject
platforms_scannedarray of string
time_windowstring
regionstring

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())