EchoTik TikTok Seller Product List
This skill lists the in-store products of a single TikTok Shop seller (store) by its
, helping cross-border sellers and marketers see exactly what a store sells and how each product performs — multi-period sales and GMV, price, rating, reviews, and commission rate.
Core Concepts
EchoTik is a TikTok Shop analytics platform. Given a store's
, this tool returns that store's product catalog with per-product metrics: title, image, price (and SPU average / min / max), sales volume and GMV across 1d/7d/15d/30d/60d/90d/total windows, rating, review count, commission rate, listing date, sales channel, and category.
Where to get a : Obtain it from the
EchoTik TikTok Seller Search skill (
linkfox-echotik-list-seller
), which lists and filters TikTok Shop stores by region, category, GMV, trend, and store type; or from the
EchoTik TikTok Seller Detail skill (
linkfox-echotik-seller-detail
).
Pagination quirk:
must be a multiple of 10 (max 100). The official upstream API caps a single page at 10; this tool internally pulls multiple pages of 10 and merges them, so
returns up to 50 merged products.
Data Fields
The response's
array contains product objects. Key fields:
| Field | Description |
|---|
| productId / asin | Product unique ID |
| title / productName | Product title |
| imageUrl / coverUrl | Product image URL |
| productImageUrls | Product image URL list |
| price | Product price |
| spuAvgPrice | SPU average price |
| minPrice / maxPrice | Min / max price |
| currency | Currency |
| totalSaleCnt | Total sales volume |
| totalSale1dCnt / 7dCnt / 15dCnt / 30dCnt / 60dCnt / 90dCnt | Sales volume (1d/7d/15d/30d/60d/90d, incremental) |
| totalSaleGmvAmt | Total GMV (revenue) |
| totalSaleGmv1dAmt / 7dAmt / 15dAmt / 30dAmt / 60dAmt / 90dAmt | GMV (1d/7d/15d/30d/60d/90d, incremental) |
| monthlySalesUnits | Monthly sales |
| productRating | Product rating |
| ratings / reviewCount | Review count |
| productCommissionRate | Commission rate (decimal, e.g. 0.05 = 5%) |
| categoryName / categoryIds | Product category name / ID list |
| salesFlagText | Main sales channel (video/livestream) |
| salesTrendFlagText | Sales trend |
| firstCrawlDt / availableDate | Listing date (YYYYMMDD integer / date string) |
| discount / offMarkText / freeShippingText | Discount / promo mark / free-shipping flag |
| isSShopText | S-store flag |
| salePropsInfo | Sales attribute info (variants: propId/propName/propValue) |
| region | Marketplace code |
| sourceTool / sourceType | Source tool / type |
Top-level fields:
,
,
,
,
,
.
Parameter Guide
| Parameter | Type | Required | Default | Description |
|---|
| sellerId | string | Yes | - | TikTok Shop store ID. Obtain from the Seller Search / Seller Detail skill. Max length 1000 |
| sellerProductSortField | integer | No | 1 | Sort field: 1=total sales, 2=total GMV, 3=SPU avg price, 4=7-day sales, 5=7-day GMV |
| sortType | integer | No | 1 | Sort order: 0=ascending, 1=descending |
| pageNum | integer | No | 1 | Page number (starts at 1) |
| pageSize | integer | No | 50 | Page size — must be a multiple of 10, max 100 |
调用方式
- API 端点：
POST /echotik/listSellerProduct
- Python 脚本：
python scripts/echotik_list_seller_product.py '<JSON 参数>' [--inline]
- 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
- 始终将完整响应写入
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-product-<timestamp>.json
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 /、最大列表字段的长度 + 前 3 条样本）
- 加 强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用
或
从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
解决认证和积分问题
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
异常情况
- 未配置API Key：环境变量未配置 ，也未配置 。
- 响应401或402状态码
- 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。
Usage Examples
1. List a store's top products by total sales
json
{
"sellerId": "7495514739648989419",
"sellerProductSortField": 1,
"sortType": 1,
"pageSize": 20,
"pageNum": 1
}
2. Rank a store's products by 7-day GMV (recent momentum)
json
{
"sellerId": "7495514739648989419",
"sellerProductSortField": 5,
"sortType": 1
}
3. Cheapest products in a store (price ascending)
json
{
"sellerId": "7495514739648989419",
"sellerProductSortField": 3,
"sortType": 0
}
Display Rules
- Present data clearly: Show products in a table with key columns — product image, title, price, total sales, 30-day sales/GMV, rating, review count, and commission rate
- Sales & GMV granularity: When relevant, show total sales and total GMV; mention multi-period breakdowns (1d/7d/15d/30d/60d/90d) are available in the saved JSON
- Commission formatting: Display as a percentage for readability (e.g. show 0.05 as "5%")
- Currency awareness: Include the field when displaying prices and GMV
- Image reference: When is present, surface it so the user can visually compare products
- Result count: Always inform the user of records and the current page; suggest pagination or tighter sorting when the result set is large
- No secondary processing: Results are live queries, not stored in a database; secondary SQL/data processing is not available
Important Limitations
- sellerId required: is mandatory; obtain it from the EchoTik TikTok Seller Search skill (
linkfox-echotik-list-seller
linkfox-echotik-seller-detail
- Store-scoped only: This lists one store's products; to discover/filter products across all TikTok Shop, use the EchoTik TikTok Product Search skill (
linkfox-echotik-list-product
- pageSize rule: Must be a multiple of 10 (max 100). Other values may be rejected or adjusted.
- Listing date format: uses integers (e.g. ).
- No region/keyword filter: This tool only takes a and sort/pagination — it does not accept keyword, region, or category filters (the store's marketplace is inferred from the seller).
- Data real-time nature: Results are live queries, not stored in a database; secondary SQL/data processing is not available.
User Expression & Scenario Quick Reference
Applicable — See what a specific TikTok Shop store sells:
| User Says | Scenario |
|---|
| "TikTok店铺商品" / "TikTok store products" | List a store's products by sellerId |
| "这个TikTok店铺在卖什么" | View a store's product catalog |
| "查看这家TikTok店铺的商品" | Deep-dive a store found via search/detail |
| "TikTok店铺销量最高的商品" | Sort store products by total sales |
| "TikTok店铺近期爆款" | Sort by 7-day sales/GMV |
| "这家店哪些商品佣金高" | Review commission rate per product |
Not applicable — Needs beyond one store's product list:
- Discovering/filtering products across all TikTok Shop (use EchoTik TikTok Product Search)
- Listing or filtering TikTok Shop stores (use EchoTik TikTok Seller Search)
- A single store's full profile (use EchoTik TikTok Seller Detail)
- TikTok creator/influencer or video analytics
- Amazon, Shopee, or other non-TikTok platform data
Boundary judgment: When users say "这个店铺卖什么" or "查看店铺商品" with a known store (sellerId or store link), this skill applies. If they want to search products across TikTok Shop by keyword/region/category, use the Product Search skill instead.
积分消耗规则
消耗 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
. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.