用途:搜索和分析 TikTok 视频数据,帮助跨境卖家与营销人员发现热门视频、对标内容策略,并评估视频级互动与销售归因。
主要能力:按区域(必填)、达人 userId、商品 productId、类目 productCategoryId、播放量区间、时长区间、发布时间区间,以及带货(salesFlag)、投流(isAd)、AI 视频(createdByAi)标记筛选视频;返回 videoId、描述、官方链接、封面、时长、分辨率、发布日期、达人信息、播放/点赞/评论/分享/收藏(含 1d/7d/30d 细分)、视频销量与 GMV、带货/投流/AI 标记、类目与关联商品等字段。支持按点赞(1)、发布时间(2)、播放量(3,默认)排序,sortType 0 升序/1 降序。
使用方式:API 端点 POST /echotik/listVideo;或运行 python scripts/echotik_list_video.py '<JSON 参数>' [--inline]。region 必填,未指定时需询问或默认 US。pageSize 须为 10 的倍数、最大 100。createdByAi 为字符串 "true"/"false"。时间参数为 Unix 秒级时间戳。结果默认落盘到 <cwd>/linkfox/<日期>/<session>/data/ 下,大于 8 KB 时 stdout 仅输出摘要,可用 --inline 强制全量打印。
适用场景:TikTok 热门视频、带货视频排行、某达人视频、投流视频、AI 视频、近期高播放视频、视频 GMV 对比等。
限制:region 必填且无默认;不支持二次 SQL 处理;单商品视频请用 linkfox-echotik-product-video;商品搜索、达人画像、直播数据、视频下载链接解析等不在范围内。销量与 GMV 为估算值。每次调用消耗 5 算力,高频调用需提醒用户。认证问题参见 references/onboarding.md。