cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis?material_id=7552078920880619527&metric=retain_ctr' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis',
params={"material_id":"7552078920880619527","metric":"retain_ctr"},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const params = new URLSearchParams({"material_id":"7552078920880619527","metric":"retain_ctr"});
const response = await fetch(`https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis?${params}`, {
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
});
const data = await response.json();
console.log(data);{
"code": 0,
"message": "success",
"data": {
"analysis": [
{
"second": 0,
"value": 0.05674191580231849
},
{
"second": 1,
"value": 1
},
{
"second": 2,
"value": 0.3881286498736163
},
{
"second": 3,
"value": 0.23097707661466052
},
{
"second": 4,
"value": 0.16935413579708883
},
{
"second": 5,
"value": 0.1273424562015166
},
{
"second": 6,
"value": 0.1087771289113571
},
{
"second": 7,
"value": 0.10790551730149045
},
{
"second": 8,
"value": 0.09221650832389088
},
{
"second": 9,
"value": 0.0956157936023708
},
{
"second": 10,
"value": 0.08785845027455766
},
{
"second": 11,
"value": 0.0784450448879979
},
{
"second": 12,
"value": 0.06545803190098493
},
{
"second": 13,
"value": 0.06833435021354484
},
{
"second": 14,
"value": 0.06554519306197158
},
{
"second": 15,
"value": 0.11278654231674365
}
],
"duration": 16,
"highlight": [
1,
9,
13
]
},
"requestId": "32bc651e-3d88-4663-8fed-75e9a97782d7"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}TikTok 广告库
广告互动时间分析
广告互动时间分析(CTR、CVR、点击数、转化数、留存数)。与/v1/tk-ads/top_ads_detail配合使用
GET
/
v1
/
tk-ads
/
interactive_time_analysis
cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis?material_id=7552078920880619527&metric=retain_ctr' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis',
params={"material_id":"7552078920880619527","metric":"retain_ctr"},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const params = new URLSearchParams({"material_id":"7552078920880619527","metric":"retain_ctr"});
const response = await fetch(`https://api.keyapi.ai/v1/tk-ads/interactive_time_analysis?${params}`, {
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
});
const data = await response.json();
console.log(data);{
"code": 0,
"message": "success",
"data": {
"analysis": [
{
"second": 0,
"value": 0.05674191580231849
},
{
"second": 1,
"value": 1
},
{
"second": 2,
"value": 0.3881286498736163
},
{
"second": 3,
"value": 0.23097707661466052
},
{
"second": 4,
"value": 0.16935413579708883
},
{
"second": 5,
"value": 0.1273424562015166
},
{
"second": 6,
"value": 0.1087771289113571
},
{
"second": 7,
"value": 0.10790551730149045
},
{
"second": 8,
"value": 0.09221650832389088
},
{
"second": 9,
"value": 0.0956157936023708
},
{
"second": 10,
"value": 0.08785845027455766
},
{
"second": 11,
"value": 0.0784450448879979
},
{
"second": 12,
"value": 0.06545803190098493
},
{
"second": 13,
"value": 0.06833435021354484
},
{
"second": 14,
"value": 0.06554519306197158
},
{
"second": 15,
"value": 0.11278654231674365
}
],
"duration": 16,
"highlight": [
1,
9,
13
]
},
"requestId": "32bc651e-3d88-4663-8fed-75e9a97782d7"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}🪙2 credits每次请求
Copy for AI
🤖 让 AI 帮你写调用代码
点击按钮复制一段结构化提示词,可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。
授权
查询参数
示例:
"7552078920880619527"
可选值(不支持多选):retain_ctr、retain_cvr、click_cnt、convert_cnt、play_retain_cnt
retain_ctr = 点击率(CTR)度量的是每一秒在观看时 点击了广告的观看者所占的百分比。计 算方法是:点击次数除以播放次数。 retain_cvr = 转化率(CVR)度量的是在视频中的每一 秒发生的转化(如关注、下载或购买) 所占的百分比。计算方法是:转化次数 除以互动次数。 click_cnt = 点击数:指该秒内广告获得的点击次数。 convert_cnt = 转化量:指在该秒产生的转化次数。 play_retain_cnt = 留存数:指在该秒仍在观看的用户数量。
可用选项:
retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt 响应
Show child attributes
Show child attributes

