用途:查询 TikTok Shop 单个公共商品详情。输入商品 URL 或 19 位商品 ID,可指定站点区域,默认 US。非搜索或排行榜工具,每次仅处理一个商品,返回请求时的公开快照。
主要能力:返回分组字段,包括 productId、status、title、category、pricing(货币、售价、原价、折扣)、sales(公开销量)、inventory(总库存、SKU、变体属性、价格、默认选项)、media(图片 URL)、seller(店铺 ID、名称、评分、位置)、reviews、shipping、actions、additional 等。嵌套字段因商品和地区而异。
参数:productInput 必填,为 tiktok.com 或其子域的 HTTPS 商品 URL(路径含 product/<19位ID>),或 19 位商品 ID 字符串;region 可选,默认 US,可用 US、GB、ID、MY、TH、VN、PH、SG、DE、FR、IT、ES。
用法:API 端点 POST /tiktok/shop/product/detail;脚本 python scripts/tiktok_shop_product_detail.py '{"productInput":"...","region":"US"}',可加 --inline 强制全量打印。完整响应默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的时间戳 JSON;大于 8 KB 时 stdout 只输出摘要。建议先看摘要,再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。同一会话同一参数组合默认只调一次,脚本带 24h 缓存;失败或空结果不得自动换关键词、翻页或改邮编连续试探,继续检索前应先告知用户会产生额外消耗。
限制:公开字段因商品、卖家、地区与店铺上下文而异;URL 必须含 product/<19位ID>;商品下架或缺货仍可能返回结构化元数据;不提供历史价格/库存趋势、排行榜或销量分析,不管理卖家账号或编辑商品;响应可能很大。每次消耗 63 算力,重复查询不同地区或商品分别计费。未配置 API Key 或遇 401、402、余额不足时按 references/onboarding.md 处理。