tiktok_ads_get_creative_analysis

Get TikTok Creative Analysis

Tiktok

Description

Break down one of your own TikTok ads in one call: its creative profile (format, hook_type, hook_text, archetype, promise_type, visual_style, pacing in cuts per 10 s, has_voiceover, has_captions, has_person_on_screen, cta_text_on_screen, duration_s, aspect_ratio), the storyboard (8-section narrative), and for its video the transcript, audio analysis and audio track, plus frames as cdn.hopkin.ai URLs (2 fps; frame N sits at N / 2 s). At most 120 frame URLs per ad; pass stride or a start/end window in seconds to list others. Media is served by URL, never inline. Needs creative intelligence on the ad's advertiser (tiktok_ads_enable_creative_intelligence). An ad that is not analyzed is not an error: status says why — not_enrolled (no analysis linked on this connection: enable the advertiser, or the ad has not spent in the lookback window yet), processing (linked, analysis still running), no_source (TikTok would not hand over the video file), failed (the media could not be mirrored or its frames extracted) — and message says what to do. To compare creatives across the advertiser (which hooks win), use tiktok_ads_get_creative_report with group_by instead.

Read-onlyIdempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_get_creative_analysis",
    "arguments": {}
  }
}

Parameters

NameTypeRequiredDescription
ad_id string Required The TikTok ad to break down, e.g. "1800000000000001" (from tiktok_ads_list_ads or a creative report row).minLength: 1, maxLength: 64, pattern: ^\d+$
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (4)
NameTypeRequiredDescription
stride integer Optional List every Nth extracted frame. Defaults to a stride that fits each video into its share of 120 frame URLs per ad (split evenly between the ad's videos).min: 1
start number Optional Only frames at or after this offset into the video, in secondsmin: 0
end number Optional Only frames at or before this offset into the video, in secondsmin: 0
connection_id string Optional Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.