Finding what's trending is a lookup; it does not make the post
get_trending_content returns posts and stats for a platform plus query. A generate 'in a trending style' is a different job, and it wastes credits.
See what's trending before you plan your next post. That is the job. Find what's trending on social is one named agent capability. get_trending_content takes a platform and a query (keyword or hashtag) and returns a list of trending posts with stats. It is a lookup. It does not render a follow-up video, does not clone a template, and does not schedule anything. Asking it to "make me the trending version" is a generate hiding in a research question, which is how you spend credits on a clip you briefed from one viral outlier instead of a pattern.
The output is a list. The next job is whichever named capability actually builds the thing — after you have looked.
What the lookup actually returns
Give the agent a platform and a keyword or hashtag. It searches for matching trending content and comes back with posts and stats so you can spot patterns. Required fields are platform and query. There is no prompt for a scene, no models list, no auto_post.
Cost is a lookup step — check your plan for details. It is not a video bill. Treating it as free creative is the other mistake: a list of other people's posts is not your brand kit, not your product still, and not permission to recreate a face you do not own.
Use it to notice structure: hook length, on-screen type, talking-head versus B-roll, a hashtag cluster. Do not use it to crown the single highest-view row as the brief. Outliers lie.
What this job is not
A teardown of one URL. Analyze a viral video or post is analyze_trend on a link you already have. Trending search finds links. Analysis scores one. Running analysis on every row in a trend list is how a 1-credit-per-analysis tool becomes a shopping spree. Search first. Analyze the two that share a structure.
Your own analytics. Check my social media performance is how your posts did. Trending is how the platform looks in a niche. Mixing them — "what's trending on my account" — is a performance job wearing a discovery name. Do not generate a new format because the trend list is loud and your own median is quiet without looking at your numbers.
A generate. "What's trending in fitness, make me five Reels" is two jobs. The first is this lookup. The second is a create or a pipeline. If you skip the list and generate "fitness trending style," you paid for a guess. If you run the list and then generate five without a pattern, you paid for a mood board and then ignored it.
Recreate. Recreate a viral template clones a Versely workflow graph. A trending TikTok in the lookup results is not that graph. Do not ask Recreate to ingest a trend row.
Look, then name the build job
The waste is briefing a generate from one viral post the lookup happened to return first. Credits go to a copy of an outlier. The lookup was supposed to save you that roll.
Habit:
- Query the niche and platform you actually post on.
- Note the structures that repeat, not the freak view count.
- Pick a named build job — slideshow, talking head, overlay, pipeline — and brief that structure.
- If you need a specific post explained, analyze that URL. Do not generate in order to understand.
Keep trend lookup off a reporting cron. Mixing "what is trending on TikTok" into a dashboard is how a reporting job turns into a content-strategy job without anyone naming the change.
FAQ
Does get_trending_content generate a video of the trend?
No. It returns a list of posts with stats. Making the follow-up is a create, edit, or pipeline capability you name next. A trend lookup that "also renders" is a generate you did not mean to buy.
Should I analyze every trending post it returns?
No. Analysis is a different named job and costs per URL. Search for patterns. Analyze one or two that represent the pattern.
Can I pass a platform without a keyword?
The tool requires platform and query. A niche, a hashtag, a product category. "TikTok, everything" is not a query this job will usefully run. Tighten the query instead of generating while you think.
Why not skip the lookup and prompt "make it viral"?
Because "viral" is not a structure. The lookup is how you see whether the niche is talking-head proof, big type, or a stitch. Generating without that is a credit spend on a format the feed is not rewarding this week — which is the definition of using the wrong job.