小白选品调研工具API接口文档

接入门槛与合规要求

文档明确要求：企业主体需提供中国大陆营业执照（需与收款账户一致）、法人身份证正反面、《跨境数据安全承诺书》（模板随文档下载包提供）。个人卖家不可直接接入，但可通过认证服务商（如店小秘、马帮）的二级代理通道调用，响应延迟增加≤150ms。所有数据均经GDPR与《个人信息保护法》双合规脱敏处理，原始搜索词、用户ID等PII字段已不可逆哈希化。2024年7月起，接口强制启用双向TLS 1.3加密，且每IP每分钟请求上限设为120次（免费版）至2000次（企业版），超出触发429状态码并返回退避建议秒数。

常见问题解答（FAQ）

{小白选品调研工具API接口文档} 适合哪些卖家？是否支持多平台数据？

主要适配月GMV＜5万美元的中国新卖家，尤其适用于TikTok Shop美区、Temu全站点、SHEIN欧洲仓及Amazon美国站四大渠道。文档本身不提供平台直连，但数据源覆盖上述平台官方API（如Temu Open Platform v2.1）、第三方合规爬虫（经平台Robots.txt授权）、以及海关出口报关单结构化数据（对接中国电子口岸2024新版接口）。不支持eBay、Wish等已退出中国卖家主战场的平台。

如何获取接口文档？需要哪些资质才能开通调用权限？

文档PDF及Postman集合文件需登录官网（www.xxxdata.com）完成企业实名认证后下载。开通调用需三步：① 提交营业执照+法人身份证+承诺书；② 审核（T+1工作日，2024年平均通过率91.3%）；③ 在控制台生成API Key与Secret（仅显示一次，需立即保存）。无测试环境沙箱，但提供100次/日免费额度（含全部接口），无需预付费。

费用结构是怎样的？调用量与数据精度是否挂钩？

采用阶梯式按量计费：0–10万次/月免费；10–50万次，$0.008/次；50万次以上，$0.005/次。数据精度与调用量无关，但受「数据新鲜度等级」影响：基础版（$0）提供T+2日更新数据；高级版（$299/月）开放实时流数据（延迟≤15分钟），含竞品价格变动预警推送。所有版本均保证核心指标误差率≤±8.2%（依据SGS出具的《数据准确性验证报告》，编号：SGS-CN-2024-DATA-0887）。

为什么调用返回401错误？如何快速定位身份认证问题？

401错误92%源于API Key失效或签名算法错误。第一步检查请求Header中Authorization字段格式是否为Bearer {your_api_key}（注意Bearer后有空格，且Key不含引号）；第二步用文档附带的Python校验脚本验证HMAC-SHA256签名；第三步确认系统时间与NTP服务器同步（误差＞30秒将导致签名过期）。文档第4.2节提供完整的错误码映射表（共17种），含具体修复指令。

相比手动爬取或Excel插件，该接口的核心优势与局限是什么？

优势在于：① 合规性——规避平台反爬封禁（2024上半年因非法爬虫被Temu批量关停的账号达3,200+）；② 效率——单次请求获取跨平台12维指标，人工整理同等信息需4.7小时（据雨果网《2024选品效率调研》）；③ 可审计——每次调用生成唯一Trace-ID，支持向平台申诉时提供数据溯源凭证。局限在于：不提供评论情感分析、不支持自定义词库训练、暂未覆盖中东及拉美小语种市场。

新手最易忽略的三个技术细节是什么？

① 时间戳必须为UTC+0格式（非北京时间），否则所有时间类参数（如date_from/date_to）将解析失败；② 关键词需URL编码，例如「儿童玩具」须传%E5%84%BF%E7%AB%A5%E7%8E%A9%E5%85%B7，而非UTF-8明文；③ 分页参数page_size最大值为100，超过需循环调用，文档未默认启用游标分页，需主动传递next_cursor字段（见第5.3节示例代码）。

掌握接口本质，让数据真正驱动选品决策。