Top posts about any topic, brand or product
search_postsFind the top-viewed organic TikTok, Instagram Reels and YouTube posts about a brand, product or hashtag in one ranked call, so you can read audience hooks and pick clips to clone.
Instructions
The POSTS people make ABOUT a subject — a brand ("liquid death"), a product, a hobby ("coffee"), a hashtag ("#homecafe") — from whoever posted them, across organic TikTok, Instagram Reels and YouTube in ONE call, ranked by views. Not the brand's own ads (search_meta_ads / research_ads) and not the people (find_creators folds these same posts into creators): use it to see what is actually being posted and watched about a subject, to find clips worth cloning (clone_video), and to read the hooks and angles an audience already responds to. About one credit per platform searched (one query each by default; queries adds "best X" / "X review" / #tag variants, each a paid call); repeats inside 20 minutes are free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic": "<topic>"
},
"name": "search_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | posts per platform, 1–60 (default 24) | |
| topic | Yes | subject, brand, product or hashtag — "liquid death", "coffee", "#homecafe" | |
| queries | No | query variants per platform, 1–4 (default 1); each is a paid search call | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| platforms | No | default all three | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |