tiktok/ads/ad-keyframe-analysis

Get ad keyframe analysis

Purpose:

• Get keyframe analysis of ad videos to understand audience retention at different time points
• Analyze which time points attract viewers most and where viewers drop off
• Help optimize ad video structure to improve completion rates

Parameters:

• material_id: Ad material ID, required parameter
• metric: Analysis metric, options:
  • retain_ctr: Retention CTR (default)
  • retain_cvr: Retention CVR
  • click_cnt: Click count
  • convert_cnt: Conversion count
  • play_retain_cnt: Play retention count

Return Description:

• keyframe_data: Keyframe data
  • time_points: List of time points (seconds)
  • retention_rates: Retention rates at corresponding time points (percentage)
  • drop_points: Time points with high drop-off rates
  • highlight_points: Time points with high viewer interest

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_keyframe_analysis",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "keyframe_data": {
      "time_points": [0, 1, 2, 3, 4, 5],
      "retention_rates": [100, 95, 88, 82, 78, 75],
      "drop_points": [2, 4],
      "highlight_points": [1, 5]
    }
  }
}

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.