用途:查询并分析 TikTok Shop 全球市场热销商品排行榜,帮助跨境卖家按日、周、月维度发现热销商品,用于选品、趋势分析与竞品情报。数据覆盖 9 个市场(US、GB、MX、ES、ID、VN、MY、TH、PH),默认 US。
主要能力:按 region 与 dateInfo 查询榜单,dateInfo 需指定 type(day/week/month)与 value,格式分别为 YYYY-MM-DD、year-weekNumber、year-month。可选 category(英文类目名)、orderby(field 支持 units_sold/gmv/total_units_sold/total_gmv/growth_rate,order 为 desc/asc,默认 desc)、page 与 pageSize(每页最多 10,默认 10)。返回字段含标题、商品 ID、价格、销量、GMV、增长率、店铺信息、类目、佣金率(基点,1000=10%)、图片、下架状态等。
使用方式:API 端点 POST /fastmoss/productRankTopSelling;脚本命令 python scripts/tiktok_top_selling_products.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY。结果默认写入工作目录 nexscope/<日期>/<会话>/data/ 下的 JSON 文件,响应体大于 8 KB 时 stdout 仅输出摘要,可用 --inline 强制完整输出。
限制:dateInfo 必填且格式严格;不支持关键词搜索;每页最多 10 条;数据有 T+1 延迟;工具消耗额度,同会话同参数默认只调用一次并有 24 小时本地缓存,失败或空结果不应自动换词重试,需先告知用户。展示时增长率带 %,佣金率需换算为百分比,价格需标注币种。