SuperAPI AI 工具集

ecommerce.tiktok-product-analytics

数据与分析

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能面向 TikTok Shop 商品分析,提供两步工作流——先用排行榜接口发现热销/高排名商品,再用详情接口查看单个商品的完整数据。

主要能力:排行榜接口(POST /kalodata/product/rank)按 region、dateRange、currency、language 及可选 sortField 返回分页榜单,每行含 product_id、product_name、unit_price、sales_volumn、revenue(video/live/showcase 渠道拆分)、revenue_growth_rate、commission_rate、launch_date。详情接口(POST /kalodata/product/detail)按 productId 返回价格区间、销量、收入(video/live/shopping_mall 拆分)、佣金率、上架日期、评论数、类目层级、所属店铺及关联视频/直播/达人数量。

使用方式:设置 NEXSCOPE_API_KEY;可调用 API 端点,或运行 python scripts/product_rank.py '<JSON参数>' [--inline] 与 python scripts/product_detail.py '<JSON参数>' [--inline]。结果默认写入 <cwd>/nexscope/<日期>/<session>/data/ 下的 JSON 文件,超过 8 KB 时 stdout 仅输出摘要,可用 --inline 强制完整输出。

限制:排行榜非关键词搜索,仅按地区与时间窗口浏览;详情必须提供 productId,无法按名称查找;pageNumber 限 1-5,pageSize 限 5-100;排行榜响应不含总数与页数;数据可能有 T+1 延迟;调用消耗 credits,同参数同会话默认只调用一次并本地缓存 24 小时,失败或空结果不应自动换参数重试;有效但为空的请求仍可能计费。展示时需标注 dateRange、region、currency,字段名 sales_volumn 保持原样,commission_rate 与 revenue_growth_rate 以百分号显示。