用途:按 sellerId 获取单个 TikTok Shop 店铺(卖家)的完整详情,用于跨境卖家与营销人员对单店做深度分析,涵盖销量、多周期 GMV、粉丝、评分、履约与达人/视频/直播触达。
主要能力:返回店铺完整对象,包括总销量与增量销量(1d/7d/30d/90d)、总 GMV 与增量 GMV、粉丝数、评分、评论数、好评率、回复率、发货率、历史商品数与在架商品数、平均 SKU 价格、最低/最高价、推广达人数、推广视频数、直播数、主要销售渠道、销售趋势、店铺身份标签、品牌店标记、本地/跨境标记、商品类目、预计上架时间(firstCrawlDt,YYYYMMDD 整数)等。
使用方式:sellerId 为必填字符串,最长 1000,需从 EchoTik TikTok Seller Search 结果或已知店铺链接/ID 获取。API 端点:POST /echotik/sellerDetail。Python 脚本:python scripts/tiktok_seller_detail.py '<JSON parameters>' [--inline]。需设置 NEXSCOPE_API_KEY,额度管理见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。
输出与成本:脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-echotik-seller-detail-<timestamp>.json;响应体不超过 8 KB 时打印完整 JSON,超过则仅输出摘要,加 --inline 可强制完整输出。该工具消耗 credits,同一会话相同参数默认只调用一次,脚本本地缓存 24 小时;失败或空结果时不要自动更换关键词、分页或筛选重试,追加查询前先告知用户。
响应处理:需外层 code 为 0 才可使用 data,非 0 为平台失败,直接展示外层 msg,不要将其措辞当作重试指令;HTTP 200 与嵌套业务状态不能替代平台校验。
限制:仅返回单个店铺详情,列出或筛选店铺需用 seller search 技能;类目 ID 为内部 ID,非可读名称;结果为实时查询,不存数据库,无法做二次 SQL/数据处理;不适用于 TikTok 商品搜索/榜单、达人分析、视频表现分析、非 TikTok 平台数据及店铺订单/物流/广告运营。