Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取广告关键帧分析/Get ad keyframe analysis

GET

https://api.tikhub.io/api/v1/tiktok/ads/get_ad_keyframe_analysis

TikTok-Ads-API

Last modified:2026-03-21 03:26:24

OperationId:get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_get

[中文]

用途:

获取广告视频的关键帧分析，了解视频在不同时间点的观众留存情况

分析哪些时间点最吸引观众，哪些时间点观众流失最多

帮助优化广告视频结构，提高观看完成率

参数:

material_id: 广告素材ID，必填参数

metric: 分析指标，可选值：

retain_ctr: 留存点击率（默认）

retain_cvr: 留存转化率

click_cnt: 点击次数

convert_cnt: 转化次数

play_retain_cnt: 播放留存量

返回内容说明:

keyframe_data: 关键帧数据

time_points: 时间点列表（秒）

retention_rates: 对应时间点的留存率（百分比）

drop_points: 流失率较高的时间点

highlight_points: 观众兴趣较高的时间点

示例响应:

{
  "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]
    }
  }
}

[English]

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]
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.tikhub.io/api/v1/tiktok/ads/get_ad_keyframe_analysis?material_id=7213258221116751874&metric' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

Modified at 2026-03-21 03:26:24

获取热门广告聚光灯/Get top ads spotlight

获取广告百分位数据/Get ad percentile data

获取广告关键帧分析/Get ad keyframe analysis

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#