SuperAPI AI 工具集

ecommerce.tiktok-batch-product-detail

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:批量获取 TikTok Shop 商品详情指标,帮助卖家与运营人员用销量、GMV、直播、视频和达人数据横向比较候选商品。

主要能力:单次最多查询 1000 个商品,可用商品 ID、TikTok Shop 商品链接定位(后端从链接中提取 productId 并与 ID 合并)。返回指标含销量、GMV、直播场次、视频数、达人数、观看量,覆盖 1d/7d/15d/30d/60d/90d 及累计口径;价格字段 minPrice、maxPrice、spuAvgPrice 以美元计。状态标记:salesTrendFlag(0 稳定、1 上升、2 下降)、isSShop(全托管)、offMark(下架)、freeShipping(免运费)。

使用方式:至少提供 productIds 或 productUrls 之一,也可同时提供。接口为 POST /echotik/batchProductDetail;脚本调用:python scripts/echotik_batch_product_detail.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY,额度管理见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。结果默认写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件;响应超过 8 KB 时标准输出仅给摘要,可用 --inline 强制完整输出,建议用 jq 等按需提取字段。调用消耗额度,同会话同参数默认仅调用一次并有 24 小时本地缓存;失败或空结果时不应自动更换关键词、分页或筛选重试,需先告知用户。

响应处理:需外层 code 为 0 才可使用数据;非 0 为平台失败,展示外层 msg 即可,不要将其理解为重试指令。

展示建议:输出对比表(名称、美元价格、总销量、30 天销量、总 GMV、评分、评论数、佣金率、推广达人数);比较趋势时同时给出相关周期与累计值;commission 按百分比显示(0.05 显示为 5%);标记全托管、下架、免运费;缺失商品要列出无数据的 ID/链接。

限制:单次上限 1000 个;价格均为美元;销量、GMV 与归因为估算数据,非平台精确值;仅用于已有 ID/链接的查询,不支持按关键词或类目搜索,也不适用新品排行、商品视频、视频下载链接、达人画像及非 TikTok 平台商品。