TikTok Ad Keyframe & Audience Retention

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

TikTok

TikTok Ad Keyframe & Audience Retention

Paste one TikTok ad material ID and choose a metric — retention CTR, retention CVR, clicks, conversions or play-retention. Default is retention CTR; an optional cookie can unlock more data.

You receive

Returns keyframe time points, retention rates, the steepest drop-off points and viewer-interest highlights for the chosen metric. This is retention data for one TikTok ad, not frame images, video downloads or editing. Pay per use, no subscription; maximum $0.0015 per call.

Start with your task

TikTok Ad Keyframe & Audience Retention

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
body`body`	`object`	Required	Required fields `material_id`
cookie`body.cookie`	`string`	Optional	自定义Cookie字符串（可选）
metric`body.metric`	`string`	Optional	分析指标/Analysis metric (retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt) Default `retain_ctr`
material_id`body.material_id`	`string`	Required	广告素材ID/Ad material ID
queryParams`queryParams`	`object`	Optional

View raw JSON

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "title": "Body_get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_post",
      "required": [
        "material_id"
      ],
      "properties": {
        "cookie": {
          "type": "string",
          "title": "Cookie",
          "description": "自定义Cookie字符串（可选）"
        },
        "metric": {
          "type": "string",
          "title": "Metric",
          "default": "retain_ctr",
          "description": "分析指标/Analysis metric (retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt)"
        },
        "material_id": {
          "type": "string",
          "title": "Material Id",
          "description": "广告素材ID/Ad material ID"
        }
      },
      "x-readme-ref-name": "Body_get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_post"
    },
    "queryParams": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Bring your agent along.
Copy the note below into your agent’s chat. It reuses an existing connection or helps set one up.
Get connected
Start with your task
Tell your agent what you want to accomplish, including any constraints that matter.
Check before you call
I will inspect this tool, confirm the inputs and current cost, and check your authorization before running it. Then I will explain the result and its limits.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

Bring your agent along.

Start with your task

Check before you call