DocsTools
TrendTrack
Brands' Meta ads, hooks and landing pages.
- Category
- Advertising
- How you connect
- API key or token. You paste a key or token from the tool. Homla stores it encrypted and never shows it again.
- Time to set up
- About 3 minutes
- Actions
- 12 read, 3 write
Connect it#
In Homla, open Connectors, then TrendTrack. The Setup guide button walks you through the same steps, with fields to paste into.
Who can do it. A TrendTrack workspace owner or admin. Public API access must be enabled for the workspace (Business plans include it; if the key page is missing, ask TrendTrack support to enable it).
- Open the API page of your TrendTrack workspace settingsSign in to TrendTrack with the workspace owner or an admin, in the workspace Homla should read. Open it.
- Create an API key and copy itCreate a new key, name it Homla so you can find it later, and copy it right away. Keys start with sk_tt_. The key reaches the whole workspace: every tracked brand, board and the shared monthly credits. Open it.
Treat the key like a password and paste it straight into Homla: it may not be shown again once you leave the page.
- Decide what Homla can doTrendTrack API keys have no scopes: a key can read everything and change tracked brands and boards. To keep people read-only, give them a read-only role in Homla: the write tools (brands_manage, boards_manage, request writes) are then hidden. Every read spends workspace credits (1 per returned row), and each Homla result shows the cost.
- Paste it into HomlaIn Homla, open Connectors, then TrendTrack, then Connect. Paste the key into TrendTrack API key and save. Homla encrypts it and never shows it again. Open it.
Paste the key only into Homla, never into a chat or an email.
What your AI can do#
These are the actions Homla gives your AI. Your role decides which ones you get. Write actions are a dry run until confirmed, see Approvals and dry runs.
Read#
Looks things up, never changes anything.
| Action | What it does |
|---|---|
trendtrack_lookup | Resolve a brand name, shop domain, Facebook page id or Instagram handle to TrendTrack ids (tracked brand, advertiser, shop). |
trendtrack_brands_list | List tracked brands (Brand Tracker) with active/new ad counts, domains, folder. |
trendtrack_brand_ads | Read a brand's Meta ad account: copy, transcript, landing page, reach, rank. |
trendtrack_brand_insights | Analytics for one tracked brand. |
trendtrack_ad_get | One ad in full: copy, video transcript, landing page, reach, rank, audience. |
trendtrack_ads_search | Search the Meta, TikTok or Google ads library by keywords and filters (status, media, countries, days running, reach...). |
trendtrack_advertisers_search | Search Meta advertisers (Facebook pages) by name, domain, copy, active ads, reach, category. |
trendtrack_shops_search | Search shops by keyword or domain with traffic, ads, products, country, tech filters. |
trendtrack_shop_get | One shop by domain or id: traffic, tech, markets. |
trendtrack_emails_search | Search captured marketing emails by keyword, shop, date, campaign type. |
trendtrack_workspace_insights | Across every tracked brand (or one folder): top/scaling ads, hooks, ad copies, landing pages, media mix. |
trendtrack_boards_list | List saved boards (folders/collections of ads, shops, emails). |
Write#
Creates or changes things, as the account owner.
| Action | What it does |
|---|---|
trendtrack_brands_manage | Track or untrack a brand, move brands between folders, create/rename/delete a folder. |
trendtrack_boards_manage Deletes | Boards: create, update, archive, restore, move, share; save an ad/shop/email to a board (item_add), item_remove, item_move. |
trendtrack_request | Any TrendTrack /v1 call without a tool (facets, freshness, usage, favorites, share links...). |
Disconnect it#
In Homla, open the account menu on the tool's page and choose Disconnect. Anyone it was shared with loses access at once. To cut it off on the tool's side too:
To cut Homla off, delete the Homla key on the TrendTrack API settings page. To rotate, create a new key there, paste it into the same Homla form, then delete the old one.
Generated from the product code. Action names are what the CLI and the API use.