Skip to main content
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.
  • limit affects only sample_videos length in the final response.

Error Responses

  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 422 - invalid query parameters (for example unsupported platform, missing keyword, or invalid limit)
  • 500 trends_brief_failed - unexpected trend brief generation failure