bodapi
首页API 产品联系我们
登录注册
bodapi

高质量数据 API 服务商

产品

  • API 产品

支持

  • 联系我们

账户

  • 登录
  • 注册
© 2026 bodapi. 保留所有权利。
概览
产品文档
版本
检索
目录
GETGet Influencer Follower List - Realtime1 额度/次GETGet Influencer Region - Realtime1 额度/次GETGet Influencer Following List - Realtime1 额度/次GETGet Influencer QR Code - Realtime1 额度/次GETGet Influencer Trends - Enriched1 额度/次GETGet Influencer Detail - Enriched1 额度/次GETGet Influencer Livestream List - Enriched1 额度/次GETGet Influencer Product List - Enriched1 额度/次GETGet Influencer Ranking List - Enriched1 额度/次GETGet Influencer Detail - Realtime1 额度/次GETGet Influencer Video List - Realtime1 额度/次GETGet Influencer List - Enriched1 额度/次GETGet Influencer Video List - Enriched1 额度/次
GETGet Shop Detail - Enriched1 额度/次GETGet Shop List - Enriched1 额度/次GETGet Shop Trends - Enriched1 额度/次GETGet Shop Product List - Enriched1 额度/次GETGet Shop Video List - Enriched1 额度/次GETGet Shop Livestream List - Enriched1 额度/次GETGet Shop Ranking List - Enriched1 额度/次GETGet Shop Influencer List - Enriched1 额度/次GETGet Shop Product List - Realtime1 额度/次
GETGet Product Detail Web - Realtime (unstable)1 额度/次GETGet Product Review List - Enriched1 额度/次GETSearch Products - Realtime1 额度/次GETGet Product Detail App - Realtime1 额度/次GETGet TikTok Shop Categories Level21 额度/次GETGet TikTok Shop Categories Level31 额度/次GETGet Product Review List - Realtime1 额度/次GETGet Product List - Enriched1 额度/次GETGet Product Detail - Enriched1 额度/次GETGet Product Influencer List - Enriched1 额度/次GETGet Product Ranking List - Enriched1 额度/次GETGet TikTok Shop Categories Level11 额度/次GETGet Product ID from Share Link - Realtime1 额度/次GETGet Product Trends - Enriched1 额度/次GETGet Product Video List - Enriched1 额度/次GETGet Product Livestream List - Enriched1 额度/次
GETInteractive time analysis - Realtime1 额度/次GETTop AD search - Realtime1 额度/次GETGet hashtag detail - Realtime1 额度/次GETGet the industry list - Realtime1 额度/次GETGet priority region - Realtime1 额度/次GETGet trend videos - Realtime1 额度/次GETGet hashtag list - Realtime1 额度/次GETGet top ads spotlight - Realtime1 额度/次GETGet top ads detail - Realtime1 额度/次GETGet top ads list - Realtime1 额度/次
GETGet Suggestions Users - Realtime1 额度/次GETGet Trending Search Term Ranking - Realtime1 额度/次GETGet Keyword Insight - Realtime1 额度/次
GETGet Music Ranking List - Realtime1 额度/次GETGet Music Video List - Realtime1 额度/次GETGet Music Detail - Realtime1 额度/次GETGet Sticker Video List - Realtime1 额度/次GETGet Sticker Detail - Realtime1 额度/次
GETGet Category Detail - Enriched1 额度/次GETGet Category Trends - Enriched1 额度/次
GETGet Video Comment Keywords - Realtime1 额度/次GETGet Video Interaction Trends - Realtime1 额度/次GETGet Influencer Milestones - Realtime1 额度/次
GETGet Top Search - Realtime1 额度/次GETSearch Product - Realtime1 额度/次GETSearch Hashtags - Realtime1 额度/次GETSearch Influencers - Realtime1 额度/次GETSearch Music - Realtime1 额度/次GETSearch Videos - Realtime1 额度/次GETSearch Live Streams - Realtime1 额度/次GETGeneral Search - Enriched1 额度/次GETImage Search Paged Product Data - Realtime1 额度/次POSTImage Search for Products - Realtime1 额度/次
GETBatch download cover images1 额度/次
GETGet Hashtag Video List - Realtime1 额度/次GETGet Video List - Enriched1 额度/次GETGet Video Ranking List - Enriched1 额度/次GETGet Recommended Video Stream - Realtime1 额度/次GETGet Trending Hashtag - Realtime1 额度/次GETGet Video Detail - Realtime1 额度/次GETGet Video Captions - Realtime1 额度/次GETGet Video Comment List - Realtime1 额度/次GETGet Video Comment Replies - Realtime1 额度/次GETGet Video Download URL - Realtime1 额度/次GETGet Video Detail - Enriched1 额度/次GETGet Video Product List - Enriched1 额度/次GETGet Video Trends - Enriched1 额度/次GETGet HashTag Trends - Enriched1 额度/次GETGet HashTag Ranking List - Enriched1 额度/次
GETGet Live List - Enriched1 额度/次GETGet Live Detail - Enriched1 额度/次GETGet Live Trends - Enriched1 额度/次GETGet Live Product List - Enriched1 额度/次GETGet Live Stream Detail - Realtime1 额度/次
API 产品/TikTok Ultra API/v1/Interactive time analysis - Realtime

部分内容暂无中文,已显示英文

Interactive time analysis - Realtime

GET/api/tiktok-ultra-api1/v1/api-v3-realtime-interactive-time-analysis1 额度/次

API Overview This realtime interactive time analysis endpoint shows how a specific ad video performs at different seconds. The response includes video duration, second-by-second metric values, and highlight timestamps, so you can analyze CTR, CVR, clicks, conversions, or retention changes across the video timeline. It is designed to be used together with the top ads detail endpoint.

Recommended Use Cases

  • Analyze the pacing and performance curve of an ad video
  • Locate high-click, high-conversion, or high-retention moments
  • Support hook editing, selling-point placement, and creative review workflows

Notes

  • Realtime endpoints may hit risk control; if the API returns code=500, keep retrying (code=500 does not consume your current usage quota)

请求参数

按参数位置分区展示 gateway 校验规则。

Query 参数

metricstringAvailable 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. enum: retain_ctr、retain_cvr、click_cnt、convert_cnt、play_retain_cntretain_ctr
类型
string
必填
否
默认值
retain_ctr
示例
retain_ctr
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. enum: retain_ctr、retain_cvr、click_cnt、convert_cnt、play_retain_cnt
material_idstring7552078920880619527
类型
string
必填
是
默认值
7552078920880619527
示例
7552078920880619527

Header 参数

X-Bodapi-Keystring在控制台的「API 密钥」页创建或查看密钥。
类型
string
必填
是
在控制台的「API 密钥」页创建或查看密钥。

请求示例

curl -X GET '/api/tiktok-ultra-api1/v1/api-v3-realtime-interactive-time-analysis?metric=retain_ctr&material_id=7552078920880619527' \
  -H "X-Bodapi-Key: $BODAPI_API_KEY"

在线调试

X-Bodapi-Key

请先登录后再使用在线调试。

点击「运行」查看实时响应结果