用途:对已持有视频 ID 或 TikTok 视频 URL 的 TikTok 视频做批量详情查询,便于卖家与营销人员横向对比视频表现。
主要能力:一次调用返回每条视频的描述、官方地址、封面、时长、宽高与清晰度、文件大小、发布日期;播放量与点赞均给出累计总量及近 1 天/7 天/30 天增量;评论、分享、收藏;估算视频销量与 GMV;达人 ID、账号 ID、头像;是否带货、是否投流、是否 AI 视频标记;关联商品与类目(JSON 字符串);区域代码与数据来源。
使用方式:至少提供 videoIds 或 videoUrls 之一,两者可同时传入,服务端合并去重后查询,各上限 1000 条。videoUrls 仅提取末尾 videoId,需确保 URL 以视频 ID 结尾。API 端点:POST /echotik/batchVideoDetail;脚本:python scripts/echotik_batch_video_detail.py '<JSON 参数>' [--inline]。结果默认落盘到 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下,响应体大于 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。
适用场景:批量查看指定视频的播放量/销量、比较哪条视频表现最好、判断视频是否带货/投流/AI。
限制:仅做已知 ID/URL 的详情查询,不按区域或筛选条件发现视频(需用 linkfox-echotik-list-video);销量、GMV 与归因为估算值;productCategoryList / videoProducts 为 JSON 字符串需自行解析;结果为实时查询,不做二次 SQL 处理;单次最多 1000 条。消耗 5 算力,高频调用前请提醒用户。未配置 API Key 或出现 401/402、余额不足时按 references/onboarding.md 处理。