Shopee官方选品调研工具API接口文档详解

Shopee官方推出的选品调研工具API（Product Research Tool API）是面向中国跨境卖家的合规数据服务接口，已集成至Shopee Seller Center 2024年Q2升级版后台，支持实时类目热度、竞品价格带、搜索词转化率等12类核心指标调用。

Shopee官方选品调研工具API接口文档详解

Shopee于2024年3月正式向中国区认证卖家（需完成KYC+店铺等级L3及以上）开放Product Research Tool API，该接口基于Shopee东南亚及拉美站点真实交易与搜索日志构建，非爬虫或第三方聚合数据。据Shopee《2024跨境卖家技术白皮书》披露，该API返回的数据延迟≤15分钟，覆盖越南、泰国、马来西亚、菲律宾、印尼、巴西6大主力市场，日均调用量上限为5,000次/账号（免费额度），超限后按$0.02/次计费。接口响应字段包含搜索热度指数（Search Volume Index, SVI）、类目供需比（Supply-Demand Ratio, SDR）、TOP10竞品平均毛利率区间三项独家指标——其中SVI以2023年Q4全站搜索总量为基准100，实测显示SVI≥85的类目在30天内上新商品GMV转化率达22.7%（Shopee内部A/B测试数据，2024年5月发布）。

该API严格遵循OAuth 2.0鉴权机制，仅支持HTTPS协议调用，所有请求须携带Seller ID、Shop ID及由Shopee Partner Portal签发的Access Token。接口返回JSON格式结构化数据，含完整字段说明、单位定义及数据更新时间戳（UTC+8）。例如，"svi": {"value": 92, "updated_at": "2024-06-15T08:32:17+08:00"}中value值为标准化整数，无小数位，避免归一化误差。据深圳某头部代运营公司实测，使用该API进行越南站母婴类目选品，新品首月动销率提升34%，退货率下降5.2个百分点（对比未使用API的对照组，样本量N=1,247款SKU）。

接入前需完成三重合规校验：① 卖家中心完成“API权限管理”模块开通（路径：Settings → API Settings → Enable Product Research Tool）；② 在Shopee Partner Portal提交《数据使用承诺书》（模板编号PR-2024-V2.1，2024年4月起强制执行）；③ 绑定企业营业执照与法人身份证信息（仅中国内地主体，港澳台及海外注册公司暂不支持）。接口文档全文托管于Shopee Developer Portal（developer.shopee.com/docs/product-research-tool-api），文档版本号v1.3.0（2024年6月10日发布），含17个端点说明、8类错误码详解及4个Postman示例集合，全部内容与生产环境实时同步。

常见问题解答

{关键词} 适合哪些卖家/平台/地区/类目？

该API仅面向已完成Shopee中国区KYC认证、店铺等级达L3（即近90天GMV≥$5,000且订单履约率≥95%）的跨境卖家；当前仅支持Shopee自营平台（不含Shopee Live或Shopee Mall独立渠道）；覆盖越南、泰国、马来西亚、菲律宾、印尼、巴西6国站点；类目支持度以Shopee官方二级类目为准，禁用类目（如药品、医疗器械）及高风险类目（如成人用品）明确排除在外，具体清单见文档附录B《Supported Categories List v1.3.0》。

{关键词} 怎么开通/注册/接入/购买？需要哪些资料？

开通无需单独购买：满足资质条件后，在Seller Center「API Settings」页面一键启用，系统自动分配Client ID与Client Secret；注册需登录Shopee Partner Portal（partner.shopee.com），完成企业认证并签署电子版《数据使用承诺书》；接入需提供营业执照副本（加盖公章）、法人身份证正反面扫描件、店铺主账号邮箱及绑定手机号——所有资料须与KYC备案完全一致，审核时效为1-3个工作日（工作日9:00-18:00），节假日顺延。

{关键词} 费用怎么计算？影响因素有哪些？

基础额度5,000次/日免费，超出部分按$0.02/次计费，费用从店铺余额自动扣除；影响实际成本的关键因子有二：一是调用频率（单次请求可批量获取最多100个关键词或50个类目数据，建议合并请求）；二是地域选择（调用巴西站数据消耗额度为其他站点的1.5倍，因本地化数据处理成本更高）；无年费、无订阅费、无隐藏成本，账单明细可在Seller Center「Finance → API Usage Report」中按日下载CSV。

{关键词} 常见失败原因是什么？如何排查？

高频失败场景包括：① Access Token过期（有效期24小时，需程序自动刷新）；② 请求Header缺失X-Shopee-Timestamp或签名错误（必须使用HMAC-SHA256算法生成Authorization头）；③ 类目ID格式错误（必须为Shopee官方三级类目ID，如越南站手机壳类目ID为123456789，不可用中文名或淘宝类目ID替代）。排查步骤：第一步检查Shopee Developer Portal中的「API Health Status」看服务是否正常；第二步使用官方提供的Signature Generator工具验证签名；第三步查看返回Error Code（如401003=Token失效，400017=类目ID不存在）。

{关键词} 和替代方案相比优缺点是什么？

对比第三方爬虫工具（如Jungle Scout Shopee插件）：优势在于数据权威性（直接源出Shopee数据库）、合规性（规避封店风险）、字段完整性（含SVI/SDR等独家指标）；劣势是地域覆盖少（不支持墨西哥、波兰等新兴站）、不支持自定义时间范围查询（仅提供最近30天滚动数据）。对比Excel手动调研：效率提升90%以上（实测100个关键词分析耗时从8.2小时降至0.45小时），但需基础开发能力——无代码用户需通过Shopee官方合作ISV（如店小蜜、马帮）调用封装版。

新手最容易忽略的点是未校验updated_at时间戳即直接用于决策——因各站点数据更新节奏不同（如印尼站每日03:00 UTC+7刷新，巴西站为06:00 UTC-3），若未做时区转换，可能导致使用过期数据。Shopee明确要求所有调用方在业务逻辑中强制校验该字段，偏差＞2小时应触发告警并拒绝使用。

掌握官方API，让选品从经验驱动转向数据驱动。