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"
}Interactive time analysis
Interactive time analysis(CTR,CVR,Clicks,Conversion,Remain)。Used in conjunction with /v1/tk-ads/top_ads_detail.
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"
}Copy for AI
Why Code When AI Can Do It For You?
Stop writing code like it’s 1970! Let AI do the heavy lifting - click the button to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.
Authorizations
Query Parameters
"7552078920880619527"
Available values: retain_ctr = Click-through rate (CTR) measures the percentage of viewers who clicked the ad while watching at every second. It is calculated by dividing the number of clicks by the number of views. retain_cvr = Conversion rate (CVR) measures the percentage of conversions created (such as follows, downloads, or purchases) at every second of the video. It is calculated by dividing the number of conversions by the number of interactions. click_cnt = The number of clicks the ad received. convert_cnt = Conversions The number of conversions generated. play_retain_cnt = Retention The number of users still watching the ad.
retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt Response
Show child attributes
Show child attributes

