Trends
Get Trend Brief
Generate a one-call TikTok trend brief for a keyword with top hashtags, sounds, creators, posting windows, hook angles, and sample videos.
GET
Generate an AI-agent ready TikTok trend brief from one keyword.
This endpoint consolidates trend videos, search results, and sounds into one
response so OpenClaw or custom agents can plan content without making multiple
trend calls.
Brief aggregation is keyword-relevance aware: when matching videos are found,
the summary/recommendation output prioritizes those matches over unrelated
high-view videos.
Public trends access is brief-only. Use this endpoint instead of any legacy
atomic trends routes.
Query Parameters
string
default:"tiktok"
Platform target. Current supported value is
tiktok.string
required
Required trend query seed (for example
morning routine, fitness, grwm).number
default:"10"
Number of videos returned in
data.evidence.sample_videos. Range: 1..30.string
default:"7d"
Trend window:
24h, 7d, or 30d.Response
string
Echoed platform (
tiktok).string
Normalized keyword used to build the brief.
string
Applied range window (
24h, 7d, 30d).string
ISO timestamp indicating when the brief payload was generated.
object
Aggregated trend snapshot.
object
Ready-to-use planning suggestions.
object
Supporting sample videos from the analyzed pool.
Caching
- Cached for 3 hours by
platform + keyword + range. limitaffects onlysample_videoslength in the final response.
Error Responses
401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API422- invalid query parameters (for example unsupportedplatform, missingkeyword, or invalidlimit)500 trends_brief_failed- unexpected trend brief generation failure
