This skill lists the in-store products of a single TikTok Shop seller (store) by its sellerId, 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 sellerId, 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 sellerId: 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: pageSize 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 pageSize=50 returns up to 50 merged products.
Data Fields
The response's products 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: errcode, errmsg, total, columns, type, costToken.
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 |
How to call
- API endpoint：
POST /echotik/listSellerProduct(For complete parameters/response/error codes seereferences/api.md） - Python script：
python scripts/echotik_list_seller_product.py '<JSON 参数>' [--inline] - Cost constraints: This tool consumes compute; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically switch keywords, paginate, or change zip codes to probe continuously; if you need to continue searching, first explain to the user that additional consumption will be incurred.
Output strategy (script default behavior)：
- Alwayswrite the complete response to
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-product-<timestamp>.json（<cwd>is the working directory when the script is executed, which in Claude Code is the current project directory;<session>is taken from the environment variableSESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable, report an error) - Response body ≤ 8 KB: after saving to disk, print the complete JSON to stdout
- Response body > 8 KB: after saving to disk, stdout outputs only a summary (top-level fields, common counts such as
total/costToken, length of the largest list field + first 3 samples) - Add
--inlineto force full printing to stdout (also saved to disk)
Data reading suggestions: First look at the summary to judge whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding the entire JSON entering the context.
Resolve authentication and compute issues
When the following abnormal situations occur, use references/onboarding.md to guide resolution:
Abnormal situations
- API Key not configured: The environment variable is not configured
LINKFOX_AGENT_API_KEY, andLINKFOXAGENT_API_KEY。 - Response 401 or 402 status code
- Response indicates insufficient compute or balance: The message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with similar meaning.
Usage Examples
1. List a store's top products by total sales
{
"sellerId": "7495514739648989419",
"sellerProductSortField": 1,
"sortType": 1,
"pageSize": 20,
"pageNum": 1
}
2. Rank a store's products by 7-day GMV (recent momentum)
{
"sellerId": "7495514739648989419",
"sellerProductSortField": 5,
"sortType": 1
}
3. Cheapest products in a store (price ascending)
{
"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
productCommissionRateas a percentage for readability (e.g. show 0.05 as "5%") - Currency awareness: Include the
currencyfield when displaying prices and GMV - Image reference: When
imageUrlis present, surface it so the user can visually compare products - Result count: Always inform the user of
totalrecords 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:
sellerIdis mandatory; obtain it from the EchoTik TikTok Seller Search skill (linkfox-echotik-list-seller) or Seller Detail skill (linkfox-echotik-seller-detail), or a known store link/ID. - 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:
firstCrawlDtusesYYYYMMDDintegers (e.g.20240504). - No region/keyword filter: This tool only takes a
sellerIdand 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 store products" / "TikTok store products" | List a store's products by sellerId |
| "What is this TikTok store selling" | View a store's product catalog |
| "View this TikTok store's products" | Deep-dive a store found via search/detail |
| "The best-selling products of a TikTok store" | Sort store products by total sales |
| "Recent hot-selling products of a TikTok store" | Sort by 7-day sales/GMV |
| "Which products in this store have high commissions" | 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 "what does this store sell" or "view store products" 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.
Compute consumption rules
Consumes 5 compute.
Users pay fees due to compute consumption. Please fully evaluate: when this skill needs to be called frequently, or the user's expectation of compute consumption is insufficient, be sure to remind the user and let the user decide whether to continue.
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.