接入指南
TikTok 数据洞察
账号概览、视频指标、行业基准——对接 TikTok 账号的分析能力
TikTok 数据洞察
对接 TikTok 官方 Accounts Insights：账号概览、视频指标、行业基准、发布设置查询。平台规则（权限分级/数据延迟/粉丝门槛）见数据洞察规则。
能力一览
| 能力 | 端点 | CLI |
|---|---|---|
| 账号概览 | GET /v1/tiktok/v1.3/business/get?account= | haina tt insight account --account <id> |
| 视频列表+指标 | GET /v1/tiktok/v1.3/business/video/list?account= | haina tt insight videos --account <id> |
| 行业基准 | GET /v1/tiktok/v1.3/business/benchmark?account=&category= | haina tt insight benchmark --account <id> --category BEAUTY |
| 发布隐私/时长设置 | GET /v1/tiktok/v1.3/business/video/settings?account= | haina tt insight video-settings --account <id> |
用法要点
- 字段集：
--fields逗号分隔透传官方字段（缺省为核心指标集）。视频字段全集见官方business/video/list文档（含完播率/受众分布/留存曲线等）。 - 时间序列：账号概览给
--start-date/--end-date（YYYY-MM-DD，UTC，回溯 ≤60 天）才回metrics日序列。 - 定点查视频：
--video-ids <postId,…>（官方 filters.video_ids；配--ad-post-only只看"仅广告展示"帖）。 - 行业基准：
--category为官方 25 类目枚举（大小写不敏感），返回平均点赞/评论/分享/粉丝数/粉丝增长/互动率/播放量/发帖数——配合tt insight account对比自己账号的行业水位。 - 发布前自检：
tt insight video-settings返回privacy_level_options（图片发布必填参数的可选档位）与max_video_post_duration_sec（超时长发布必失败）。