linkfox-echotik-list-video-rank

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EchoTik - TikTok Video Ranking

EchoTik - TikTok 视频排行榜

This skill queries TikTok Shop video ranking data via the EchoTik data source, helping cross-border sellers and marketers discover top-performing videos on a given day across regional markets. Unlike

linkfox-echotik-list-video

(which lists videos by region with free filters), this tool returns a dated ranking of videos sorted by a chosen metric.

本技能通过EchoTik数据源查询TikTok Shop视频排行数据，帮助跨境卖家和营销人员发现指定日期各区域市场内表现最佳的视频。与

linkfox-echotik-list-video

（按区域列出视频并支持自由筛选）不同，本工具返回的是按选定指标排序的日期维度排行榜。

Core Concepts

核心概念

EchoTik is a TikTok Shop analytics platform. This tool returns ranked video lists — daily snapshots of the top videos in a market, ordered by a selected ranking metric. It is the video counterpart of the new-product ranking: instead of scouting new products, you scout the day's best-performing videos.

Required input:

date

rankType

region

, and

videoRankField

are all mandatory. There are no defaults for required fields.

Related skill: To list videos by region with free filters (creator / product / views range / ad / AI flags) instead of a dated ranking, use

linkfox-echotik-list-video

. This skill is for ranked, date-scoped video charts.

EchoTik是一款TikTok Shop数据分析平台。本工具返回的是排名视频列表——即某一市场中当日热门视频的快照，按选定的排名指标排序。它相当于新品排行榜的视频版：无需挖掘新品，而是发掘当日表现最优的视频。

必填输入：

date

、

rankType

、

region

和

videoRankField

均为必填项，无默认值。

关联技能：若需按区域列出视频并使用自由筛选条件（创作者/产品/播放量范围/广告/AI标识）而非日期维度排行榜，请使用

linkfox-echotik-list-video

。本技能适用于带日期范围的排名视频榜单。

Data Fields

数据字段

The response

data[*]

video object has 25 fields. Metric names begin with

total

but represent the ranking period's cumulative value (daily, for

rankType:1

). Key fields:

Field	Description
videoId / officialUrl / coverUrl	Video ID / TikTok URL / cover image URL
videoDesc / duration / createDate	Description / duration (seconds) / publish date
userId / uniqueId / nickName / avatar	Creator ID / TikTok account ID / nickname / avatar
category / region	Video category / marketplace code
totalViewsCnt / totalDiggCnt / totalCommentsCnt	Period views / likes / comments
totalSharesCnt / totalFavoritesCnt	Period shares / favorites
totalVideoSaleCnt / totalVideoSaleGmvAmt	Period video sales (units, estimated) / sales GMV (estimated)
salesFlagText / createdByAiText	Selling video flag / AI video flag (是/否)
productCategoryList / videoProducts	Selling product categories / products
sourceType / sourceTool	Product source / source tool

Full field list with types is in
references/api.md
. This shape differs from
linkfox-echotik-list-video
(no width/height/ratio, no 1d/7d/30d breakdowns, no
isAdText
).

响应结果中的

data[*]

视频对象包含25个字段。指标名称以

total

开头，但代表排行周期内的累计值（当

rankType:1

时为单日累计）。关键字段如下：

字段	描述
videoId / officialUrl / coverUrl	视频ID / TikTok链接 / 封面图片链接
videoDesc / duration / createDate	视频描述 / 时长（秒） / 发布日期
userId / uniqueId / nickName / avatar	创作者ID / TikTok账号ID / 昵称 / 头像
category / region	视频分类 / 站点代码
totalViewsCnt / totalDiggCnt / totalCommentsCnt	周期播放量 / 点赞量 / 评论量
totalSharesCnt / totalFavoritesCnt	周期分享量 / 收藏量
totalVideoSaleCnt / totalVideoSaleGmvAmt	周期视频销量（估算单位数） / 视频GMV（估算值）
salesFlagText / createdByAiText	带货视频标识 / AI生成视频标识（是/否）
productCategoryList / videoProducts	带货产品分类 / 产品列表
sourceType / sourceTool	产品来源 / 来源工具

完整字段列表及类型请查看
references/api.md
。本工具返回的数据结构不同于
linkfox-echotik-list-video
（无宽/高/比例字段，无1天/7天/30天数据细分，无
isAdText
字段）。

Parameter Guide

参数指南

Parameter	Type	Required	Default	Description
date	string	Yes	-	Query date, `YYYY-MM-DD`
rankType	integer	Yes	-	Ranking type (see values below)
region	string	Yes	-	Marketplace code. See supported list below
videoRankField	integer	Yes	-	Ranking metric (see values below)
pageNum	integer	No	1	Page number, starts at 1
pageSize	integer	No	50	Items per page

参数	类型	必填	默认值	描述
date	string	是	-	查询日期，格式为 `YYYY-MM-DD`
rankType	integer	是	-	排行类型（取值见下方说明）
region	string	是	-	站点代码，支持列表见下方
videoRankField	integer	是	-	排行指标（取值见下方说明）
pageNum	integer	否	1	页码，从1开始
pageSize	integer	否	50	每页条数

rankType values

rankType取值

Value	Meaning
1	Daily ranking (verified)

取值	含义
1	每日排行榜（已验证）

videoRankField values

videoRankField取值

Value	Meaning	Verified
1	Rank by views (播放量)	✓ 200
2	Rank by video sales (视频销量)	✓ 200
3+	Unverified	Returns errcode 10000 (no pre-computed chart) for tested date/region

Metric sparsity: when ranking by a given
videoRankField
, the other metric fields often return 0 (ranking by sales → views/likes/comments are 0; ranking by views → sales/GMV are 0). The full valid-value sets are defined by the upstream EchoTik service; confirm against
references/api.md
and real responses before combining unfamiliar values.

取值	含义	已验证
1	按播放量排行	✓ 200
2	按视频销量排行	✓ 200
3+	未验证	针对测试日期/区域会返回错误码10000（无预计算榜单）

指标稀疏性：当按指定
videoRankField
排行时，其他指标字段常返回0（按销量排行→播放量/点赞/评论为0；按播放量排行→销量/GMV为0）。完整有效值集合由上游EchoTik服务定义；在组合不熟悉的取值前，请对照
references/api.md
和实际响应确认。

Supported Marketplaces

支持的站点

US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)

When the user doesn't specify a marketplace, ask or default to US.

US（美国）、ID（印度尼西亚）、TH（泰国）、PH（菲律宾）、MY（马来西亚）、VN（越南）、GB（英国）、MX（墨西哥）、SG（新加坡）、SA（沙特阿拉伯）、BR（巴西）、ES（西班牙）、JP（日本）、DE（德国）、IT（意大利）、FR（法国）

当用户未指定站点时，请询问用户或默认使用US。

调用方式

API 端点：
```
POST /echotik/listVideoRank
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_video_rank.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-video-rank-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /echotik/listVideoRank
```
（完整参数/响应/错误码请查看
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_video_rank.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话中同一参数组合默认仅调用一次，脚本带有24小时本地缓存。若调用失败或返回空结果，不得自动更换关键词、翻页或修改参数连续尝试；如需继续检索，需先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-video-rank-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp目录，若当前目录不可写则报错）
响应体≤8 KB：写入文件后将完整JSON打印到标准输出（stdout）
响应体>8 KB：写入文件后标准输出仅打印摘要信息（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度+前3条样本）
添加
```
--inline
```
参数可强制将全量内容打印到标准输出（同时仍会写入文件）

读数据建议：先查看摘要判断是否满足需求；如需提取具体字段，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免将整份JSON带入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

出现以下异常情况时，请按照

references/onboarding.md

中的指引解决：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

Usage Examples

使用示例

1. Top US videos by views on a given day

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "US",
  "videoRankField": 1,
  "pageNum": 1,
  "pageSize": 20
}

2. Top UK videos on a given day

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "GB",
  "videoRankField": 1
}

3. Paginate a large ranking

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "US",
  "videoRankField": 1,
  "pageNum": 2,
  "pageSize": 20
}

1. 指定日期美国地区按播放量排行的热门视频

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "US",
  "videoRankField": 1,
  "pageNum": 1,
  "pageSize": 20
}

2. 指定日期英国地区的热门视频排行

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "GB",
  "videoRankField": 1
}

3. 分页获取大型排行榜数据

json

{
  "date": "2026-08-10",
  "rankType": 1,
  "region": "US",
  "videoRankField": 1,
  "pageNum": 2,
  "pageSize": 20
}

Display Rules

展示规则

Present data in tables: Show video description (truncated if long), views, likes, comments, shares, video sales, video GMV, publish date, and creator ID.
Rank order: Results are already ranked by the chosen
```
videoRankField
```
; preserve and surface the ranking order.
Link to original: When
```
officialUrl
```
is available, provide it so users can view the video on TikTok.
Estimation notice: Video sales and GMV are estimated values; remind users these are approximations.
Result count: Always inform the user of
```
total
```
records and the current page; suggest pagination when the result set is large.

以表格形式呈现数据：展示视频描述（过长时截断）、播放量、点赞量、评论量、分享量、视频销量、视频GMV、发布日期及创作者ID。
排行顺序：结果已按选定的
```
videoRankField
```
排序，请保留并突出显示排行顺序。
跳转原视频：若
```
officialUrl
```
可用，提供该链接以便用户在TikTok上查看原视频。
估算值提示：视频销量和GMV为估算值，请提醒用户这些为近似数据。
结果数量：始终告知用户总记录数及当前页码；当结果集较大时，建议用户分页查看。

Important Limitations

重要限制

All four required fields:
```
date
```
,
```
rankType
```
,
```
region
```
,
```
videoRankField
```
are mandatory; no defaults are applied.
Daily granularity:
```
date
```
is a daily snapshot; pass one specific
```
YYYY-MM-DD
```
.
Ranking data lags 1–2 days: The current day and yesterday usually have no ranking yet and return
```
errcode:10000
```
("no matching data"). Use a date 2+ days in the past; if a date still returns 10000, step further back.
Ranking vs. listing: This is a dated ranking. For region-scoped video listing with free filters (creator / views range / ad / AI flags), use
```
linkfox-echotik-list-video
```
.
No secondary processing: Results are live queries; secondary SQL/data processing is not available.

四个必填字段：
```
date
```
、
```
rankType
```
、
```
region
```
和
```
videoRankField
```
均为必填项，无默认值。
日粒度：
```
date
```
为单日快照，需传入具体的
```
YYYY-MM-DD
```
格式日期。
排行数据延迟1-2天：当日及昨日通常暂无排行数据，调用会返回
```
errcode:10000
```
（“无匹配数据”）。请使用2天及更早的日期；若该日期仍返回10000，请尝试更早的日期。
排行与列表的区别：本工具提供的是日期维度的排行榜。若需按区域列出视频并使用自由筛选条件（创作者/播放量范围/广告/AI标识），请使用
```
linkfox-echotik-list-video
```
。
无二次处理：结果为实时查询数据，不支持二次SQL/数据处理。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — TikTok video ranking / charts:

User Says	Scenario
"TikTok视频排行" / "TikTok top video chart"	Daily video ranking by views
"今天TikTok最火的视频"	Today's ranking, region scoped
"TikTok带货视频排行"	Ranked selling videos (inspect sales/GMV columns)
"英国TikTok视频榜单"	region=GB ranking

Not applicable — Needs beyond dated video ranking:

Region-scoped video listing with free filters (use
```
linkfox-echotik-list-video
```
)
Videos for one specific product by
```
productId
```
(use
```
linkfox-echotik-product-video
```
)
Video download URL resolution (use
```
linkfox-echotik-get-video-download-url
```
)
TikTok product / seller rankings

Boundary judgment: When users say "视频排行/视频榜单/最火视频" with a date or region context, this skill applies. If they want to filter videos by creator, views range, or ad/AI flags without a ranking, use

linkfox-echotik-list-video

适用场景 — TikTok视频排行/榜单：

用户表述	场景
"TikTok视频排行" / "TikTok top video chart"	按播放量排序的每日视频排行榜
"今天TikTok最火的视频"	指定地区的当日排行榜
"TikTok带货视频排行"	带货视频排行榜（查看销量/GMV列）
"英国TikTok视频榜单"	region=GB的排行榜

不适用场景 — 超出日期维度视频排行的需求：

按区域列出视频并使用自由筛选条件（请使用
```
linkfox-echotik-list-video
```
）
通过
```
productId
```
查询某一特定产品的相关视频（请使用
```
linkfox-echotik-product-video
```
）
解析视频下载链接（请使用
```
linkfox-echotik-get-video-download-url
```
）
TikTok产品/卖家排行榜

边界判断：当用户提及“视频排行/视频榜单/最火视频”且带有日期或地区上下文时，适用本技能。若用户希望按创作者、播放量范围或广告/AI标识筛选视频但无需排行，请使用

linkfox-echotik-list-video

。

积分消耗规则

消耗 5 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

消耗5积分。

用户会因积分消耗产生费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任意情况时，请通过反馈API自动检测并提交反馈：

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不符
用户对本技能表达不满或赞赏
任何你认为可以改进的内容

请按照

references/api.md

中的说明调用反馈API，请勿打断用户的操作流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills.