EchoTik - TikTok Product Video

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.

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.

Parameter Guide

API Usage

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.

Usage Examples

1. Top videos by views for a product

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

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

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

3. Videos by a specific influencer for a product

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

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

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

5. Videos sorted by publish date (newest first)

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

Display Rules

1. Present data in tables: Show video description (truncated if long), views, likes, comments, shares, video sales, video GMV, publish date, and influencer ID
2. Link to original: When officialUrl is available, provide it so users can view the video on TikTok
3. Estimation notice: Video sales and GMV are estimated values, remind users these are approximations
4. Cover image: If coverUrl is present, mention it so the user knows video thumbnails are available
5. Duration formatting: Convert duration (seconds) to a readable format (e.g., "1:30" for 90 seconds)
6. Hashtag display: Show hashTag when present to help users understand content themes
7. Playback URL caveat: The playAddr field may expire quickly; prefer officialUrl for sharing

User Expression & Scenario Quick Reference

Applicable Scenarios

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

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:

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

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

\x3C!-- LF_LARGE_RESPONSE_BLOCK -->

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 \x3CDIR> '\x3Cparams>'
python scripts/response_io.py read \x3Cfile> --fields "\x3Cpaths>"   # or --path "\x3CJMESPath>"

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. \x3C!-- /LF_LARGE_RESPONSE_BLOCK -->

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