SuperAPI AI 工具集

linkfox-echotik-list-video-rank

营销与增长

查看项目

更新于 10-16 06:23

技能介绍

用途:通过 EchoTik 数据源查询 TikTok Shop 视频排行榜,帮助跨境卖家与营销人员发现日榜、周榜或月榜中表现最佳的视频,并按选定指标排序。与 linkfox-echotik-list-video(按区域列出视频、支持自由筛选)不同,本技能返回带日期的排序榜单。

主要能力:返回指定日/周/月的视频排名,支持按播放量或视频销量排序。每条视频数据含 25 个字段,指标名以 total 开头但代表排名周期内的累计值,包括 videoId、officialUrl、coverUrl、videoDesc、duration、createDate、userId、uniqueId、nickName、avatar、category、region、totalViewsCnt、totalDiggCnt、totalCommentsCnt、totalSharesCnt、totalFavoritesCnt、totalVideoSaleCnt、totalVideoSaleGmvAmt、salesFlagText、createdByAiText、productCategoryList、videoProducts、sourceType、sourceTool 等。其中视频销量与 GMV 为估算值。

使用方式:date、rankType、region、videoRankField 四个必填项无默认值。rankType:1 日榜、2 周榜、3 月榜。videoRankField:1 按播放量、2 按视频销量。可选参数 productCategoryId(一级商品类目,用于销量榜筛选)、createdByAi(true/false,AI 视频筛选)、pageNum(默认 1)、pageSize(10 的倍数,最大 100,默认 50)。API 端点:POST /echotik/listVideoRank。Python 脚本:python scripts/echotik_list_video_rank.py '<JSON 参数>' [--inline]。响应默认落盘到工作目录下 linkfox/<日期>/<session>/data/ 的 JSON 文件,超过 8 KB 时 stdout 只输出摘要。支持 US、ID、TH、PH、MY、VN、GB、MX、SG、SA、BR、ES、JP、DE、IT、FR 共 16 个站点,用户未指定时询问或默认 US。

适用场景:TikTok 视频排行、日/周/月最火视频、带货视频榜、指定国家视频榜单,且用户带有日期或区域上下文时。若仅需按创作者、播放量范围或广告/AI 标记筛选视频,应使用 linkfox-echotik-list-video;查询单个商品视频用 linkfox-echotik-product-video;解析下载地址用 linkfox-echotik-get-video-download-url。

限制:四个必填字段缺一不可;榜单数据有 1 至 2 天延迟,近期数据可能返回 errcode:10000(无匹配数据);按某一指标排序时其他指标可能返回 0;结果为实时查询,不支持二次 SQL/数据处理;调用消耗 5 算力,用户会因算力消耗付费,需提醒;认证或算力异常时按 onboarding 文档处理。未提供价格、平台版本等更多信息。