linkfox-echotik-product-video

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EchoTik - TikTok Product Video

EchoTik - TikTok商品视频

This skill guides you on how to query promotional videos associated with a TikTok Shop product, helping sellers analyze video marketing performance and identify effective influencer content strategies.

本技能将指导您查询TikTok Shop商品的关联推广视频，帮助卖家分析视频营销表现并制定有效的达人内容策略。

Core Concepts

核心概念

This tool retrieves the list of promotional videos linked to a specific TikTok product. Each video record includes engagement metrics (views, likes, comments, shares, favorites), estimated sales attribution (video sales count and GMV), video metadata (duration, resolution, publish date), and the creator (influencer) ID. This enables sellers to understand which videos drive the most sales for a product and what content patterns work best.

Required input: A

productId

is mandatory. You can obtain product IDs from the EchoTik product search tool (

linkfox-echotik-product-search

) or the new product ranking tool (

linkfox-echotik-new-product-rank

Sort fields: Videos can be sorted by views (1), likes (2), shares (3), video sales (4), video GMV (5), or publish date (6).

Pagination:

pageSize

must be a multiple of 10, max 100. The backend fetches in batches of 10 and merges results.

本工具可获取特定TikTok商品的关联推广视频列表。每条视频记录包含互动指标（播放量、点赞数、评论数、分享数、收藏数）、预估销量归因（视频销量及GMV）、视频元数据（时长、分辨率、发布日期）以及创作者（达人）ID。卖家可借此了解哪些视频为商品带来最多销量，以及何种内容模式效果最佳。

必填输入：必须提供

productId

。您可通过EchoTik商品搜索工具（

linkfox-echotik-product-search

）或新品排行榜工具（

linkfox-echotik-new-product-rank

）获取商品ID。

排序字段：可按播放量（1）、点赞数（2）、分享数（3）、视频销量（4）、视频GMV（5）或发布日期（6）对视频进行排序。

分页设置：

pageSize

必须为10的倍数，最大值为100。后端会以10条为一批次获取数据并合并结果。

Parameter Guide

参数指南

Parameter	Type	Required	Description	Default
productId	string	Yes	TikTok product ID	-
userId	string	No	Filter by influencer ID	-
productVideoSortField	integer	No	Sort field: 1=views, 2=likes, 3=shares, 4=video sales, 5=video GMV, 6=publish date	1
sortType	integer	No	Sort order: 0=ascending, 1=descending	1
minCreateTime	integer	No	Video publish start time (Unix timestamp in seconds)	-
maxCreateTime	integer	No	Video publish end time (Unix timestamp in seconds)	-
pageNum	integer	No	Page number	1
pageSize	integer	No	Results per page (multiple of 10, max 100)	50

参数	类型	是否必填	描述	默认值
productId	string	是	TikTok商品ID	-
userId	string	否	按达人ID筛选	-
productVideoSortField	integer	否	排序字段：1=播放量，2=点赞数，3=分享数，4=视频销量，5=视频GMV，6=发布日期	1
sortType	integer	否	排序顺序：0=升序，1=降序	1
minCreateTime	integer	否	视频发布开始时间（Unix时间戳，单位秒）	-
maxCreateTime	integer	否	视频发布结束时间（Unix时间戳，单位秒）	-
pageNum	integer	否	页码	1
pageSize	integer	否	每页结果数（10的倍数，最大值100）	50

API Usage

API 使用说明

This tool calls the LinkFox tool gateway API. See

references/api.md

for calling conventions, request parameters, and response structure. You can also execute

scripts/echotik_list_product_video.py

directly to run queries.

本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请查看

references/api.md

。您也可直接执行

scripts/echotik_list_product_video.py

来运行查询。

Usage Examples

使用示例

1. Top videos by views for a product

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. Find highest-converting videos (by video sales)

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 4,
  "sortType": 1,
  "pageSize": 20
}

3. Videos by a specific influencer for a product

json

{
  "productId": "1729382310407603945",
  "userId": "7234567890123456789",
  "productVideoSortField": 1,
  "sortType": 1
}

4. Recent videos in a time range (sorted by GMV)

json

{
  "productId": "1729382310407603945",
  "minCreateTime": 1717200000,
  "maxCreateTime": 1719792000,
  "productVideoSortField": 5,
  "sortType": 1
}

5. Videos sorted by publish date (newest first)

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 6,
  "sortType": 1,
  "pageSize": 50
}

1. 按播放量排序的商品热门视频

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. 查找转化量最高的视频（按视频销量排序）

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 4,
  "sortType": 1,
  "pageSize": 20
}

3. 特定达人推广该商品的视频

json

{
  "productId": "1729382310407603945",
  "userId": "7234567890123456789",
  "productVideoSortField": 1,
  "sortType": 1
}

4. 特定时间范围内的近期视频（按GMV排序）

json

{
  "productId": "1729382310407603945",
  "minCreateTime": 1717200000,
  "maxCreateTime": 1719792000,
  "productVideoSortField": 5,
  "sortType": 1
}

5. 按发布日期排序的视频（最新优先）

json

{
  "productId": "1729382310407603945",
  "productVideoSortField": 6,
  "sortType": 1,
  "pageSize": 50
}

Display Rules

展示规则

Present data in tables: Show video description (truncated if long), views, likes, comments, shares, video sales, video GMV, publish date, and influencer ID
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
Cover image: If
```
coverUrl
```
is present, mention it so the user knows video thumbnails are available
Duration formatting: Convert
```
duration
```
(seconds) to a readable format (e.g., "1:30" for 90 seconds)
Hashtag display: Show
```
hashTag
```
when present to help users understand content themes
Playback URL caveat: The
```
playAddr
```
field may expire quickly; prefer
```
officialUrl
```
for sharing

表格展示数据：显示视频描述（过长时截断）、播放量、点赞数、评论数、分享数、视频销量、视频GMV、发布日期及达人ID
提供原视频链接：若存在
```
officialUrl
```
，请提供该链接以便用户在TikTok上查看视频
预估数据提示：视频销量及GMV为预估数值，需提醒用户这些为近似值
封面图片说明：若存在
```
coverUrl
```
，需告知用户可获取视频缩略图
时长格式化：将
```
duration
```
（秒）转换为易读格式（例如，90秒显示为“1:30”）
话题标签展示：若存在
```
hashTag
```
，需展示该标签以帮助用户理解内容主题
播放链接注意事项：
```
playAddr
```
字段可能会快速过期，分享时优先使用
```
officialUrl
```

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable Scenarios

适用场景

User Says	Scenario
"Show me the promotional videos for this TikTok product"	Query videos by product ID
"Which videos are driving the most sales for this product"	Sort by video sales (field 4)
"What influencer videos are promoting this product"	General video list query
"Show me videos by a specific creator for this product"	Filter by userId
"Recent promotional videos for this product"	Filter by time range or sort by date
"Which TikTok videos have the highest GMV for this product"	Sort by video GMV (field 5)
"Analyze the video marketing performance of this product"	Comprehensive video list query

用户表述	场景
"Show me the promotional videos for this TikTok product"	按商品ID查询视频
"Which videos are driving the most sales for this product"	按视频销量排序（字段4）
"What influencer videos are promoting this product"	通用视频列表查询
"Show me videos by a specific creator for this product"	按userId筛选
"Recent promotional videos for this product"	按时间范围筛选或按日期排序
"Which TikTok videos have the highest GMV for this product"	按视频GMV排序（字段5）
"Analyze the video marketing performance of this product"	综合视频列表查询

Not Applicable Scenarios

不适用场景

Searching for products (use
```
linkfox-echotik-product-search
```
instead)
TikTok new product rankings (use
```
linkfox-echotik-new-product-rank
```
instead)
Influencer profile analytics (follower count, bio, overall performance)
TikTok live-stream data
Video content creation or editing advice
TikTok advertising / ad campaign management
Non-TikTok platform video data

商品搜索（请使用
```
linkfox-echotik-product-search
```
）
TikTok新品排行榜（请使用
```
linkfox-echotik-new-product-rank
```
）
达人主页分析（粉丝数、简介、整体表现）
TikTok直播数据
视频内容创作或编辑建议
TikTok广告/广告活动管理
非TikTok平台的视频数据

Boundary Judgment

边界判断

When users ask about "TikTok videos", determine whether they want videos associated with a specific product (this skill) or general TikTok video analytics (not this skill). If they mention a product ID or ask "what videos are promoting product X", this skill applies. If they ask about trending videos in general without a product context, this skill does not apply.

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.

当用户询问“TikTok视频”时，需判断其需求是查看特定商品的关联视频（适用本技能）还是通用TikTok视频分析（不适用本技能）。若用户提及商品ID或询问“哪些视频在推广商品X”，则适用本技能；若用户询问无商品背景的热门视频，则不适用本技能。

反馈：

出现以下情况时，请自动检测并通过Feedback API反馈：

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

请按照

references/api.md

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

Handling Large Responses

大响应处理

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:

python scripts/response_io.py run --script scripts/echotik_list_product_video.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick
--out-dir
outside any git working tree (e.g.
/tmp/...
on Unix,
%TEMP%/...
on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

run

writes the full response to a file and emits only a schema preview + file path.

read

projects specific fields, with

--limit/--offset

for slicing and

--format json|jsonl|csv|table

for output.

When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:

High field count per record, or fields you don't need
Batch/paginated results (multiple items per call)
Long-text fields (descriptions, reviews, HTML, time series)
Output reused across later steps rather than consumed immediately

For small, single-use responses, calling the main script directly is fine.

⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via

read

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

为避免超出Agent上下文限制，请将响应保存到磁盘并仅提取所需字段：

python scripts/response_io.py run --script scripts/echotik_list_product_video.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # 或使用 --path "<JMESPath>"

请将
--out-dir
设置在Git工作区之外（例如Unix系统的
/tmp/...
，Windows系统的
%TEMP%/...
）。保存的响应可能包含个人身份信息（PII）、定价或敏感认证数据——请勿提交这些文件。文件不会自动删除，任务完成后请清理。

run

命令将完整响应写入文件，并仅输出 schema 预览 + 文件路径。

read

命令提取指定字段，支持通过

--limit/--offset

进行切片，以及通过

--format json|jsonl|csv|table

设置输出格式。

何时优先使用此模式——根据响应特征判断，例如：

每条记录字段数量多，或包含不需要的字段
批量/分页结果（每次调用返回多条数据）
长文本字段（描述、评论、HTML、时间序列）
输出需在后续步骤重复使用，而非立即消耗

对于小型、单次使用的响应，直接调用主脚本即可。

⚠️ 预览内容为截断的schema + 示例，并非完整数据。任何字段级别的操作都必须通过

read

命令从保存的文件中读取。

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