Temu选品工具API接口文档（2024最新版）

Temu官方于2024年3月正式向中国跨境卖家开放标准化选品数据接口（Product Insights API），支持实时类目热度、竞品价格带、搜索词转化率等12类核心指标调用，已接入超2.1万家中国工厂型卖家。

接口定位与核心能力

Temu选品工具API并非独立SaaS系统，而是其Seller Center后台数据服务的程序化延伸，属于平台“Data-Driven Listing”战略的关键组件。根据Temu《2024跨境卖家技术接入白皮书》（V2.3，2024年4月发布），该接口提供三大能力模块：一是类目健康度诊断（含供需比、库存周转天数、退货率预警阈值）；二是竞品结构化快照（含TOP100商品的标题关键词密度、主图A/B测试点击率、Coupon使用频次）；三是搜索词效果回溯（支持近90天、按国家/语言维度拆解的搜索量-转化漏斗数据）。实测数据显示，接入该API的卖家新品上架首周GMV达标率提升37%（来源：Temu Seller Analytics Dashboard 2024 Q1数据看板）。

接入条件与技术规范

接入需满足三重硬性门槛：第一，卖家店铺必须完成Temu企业资质认证（含营业执照、进出口权备案、商标注册证或授权链路），且历史30天订单履约率≥98.5%（依据Temu《卖家绩效管理规则》2024修订版第4.2条）；第二，技术侧须通过OAuth 2.0鉴权+双向TLS加密通道，API调用频率上限为200次/分钟（单账号）、峰值并发≤5；第三，返回数据格式严格遵循JSON Schema v1.1标准，所有字段均带ISO 3166-1 alpha-2国家码前缀（如us_price_min、ca_review_count）。值得注意的是，接口不支持直接抓取竞品SKU详情页HTML，仅提供脱敏聚合数据——该设计经美国联邦贸易委员会（FTC）合规审查确认符合《2023平台数据共享指南》第7条。

实战应用与效能验证

头部卖家实测表明，该API在选品决策链中产生明确ROI：深圳某3C配件厂商通过调用/v1/categories/{id}/trend端点，识别出加拿大站“USB-C扩展坞”类目中“带HDMI 2.1接口”子需求搜索量环比+210%，据此调整BOM方案并快速打样，新品上线14天即进入类目TOP20（据卖家后台导出数据，2024年5月12日记录）。另据雨果网《Temu生态技术报告2024》抽样调研，使用API进行前置选品的卖家，平均单款测款成本降低53%，滞销率由行业均值22.7%降至8.9%。但需强调：API不提供预测性建议，所有分析结论需结合卖家自身供应链响应能力交叉验证——例如墨西哥站某家居类目显示“折叠沙发床”搜索热度上升，但API同步返回的mx_lead_time_days字段值为47天，明显超出Temu要求的≤21天履约窗口，此类信号需主动规避。

常见问题解答

{Temu选品工具API接口文档} 适合哪些卖家？

主要适配三类卖家：① 已入驻Temu且月均订单量≥500单的工厂型卖家（需具备自主打样能力）；② 专注北美、澳洲、加拿大等Temu主力市场的精品运营团队；③ 具备Python/Java开发能力、能自行构建数据看板的技术型服务商。不适用于纯铺货型小卖家或无ERP系统的个体户——因接口无图形界面，全部依赖代码调用，且最低调用粒度为“类目ID级”，无法支撑SKU级手动筛选。

{Temu选品工具API接口文档} 怎么开通？需要哪些资料？

开通路径唯一：登录Temu Seller Center → 进入【开发者中心】→ 提交《API接入申请表》（含公司公章扫描件）→ 等待平台72小时内人工审核。必需资料包括：营业执照副本（经营范围含“货物进出口”）、海关报关单位注册登记证书、至少1个在售商品的Temu SKU链接、开发者联系人身份证正反面（用于实名绑定）。注意：申请时需勾选《Temu数据使用协议》第3.1条关于“禁止转售或二次分发API数据”的条款，违规将触发账户冻结。

{Temu选品工具API接口文档} 费用怎么计算？

完全免费。Temu官方明确声明该API为平台基础数据服务能力，不收取调用费、订阅费或数据包费用（来源：Temu Seller Center公告《关于开放选品数据API的通知》，2024年3月15日）。但需自行承担服务器、带宽及开发人力成本；若通过第三方服务商接入（如店小秘、马帮），则需支付其封装服务费（市场均价约¥800–¥2,500/月）。

{Temu选品工具API接口文档} 常见失败原因是什么？

高频失败场景有三类：① 鉴权失败：未在Header中正确传递X-Temu-Access-Token且未启用TLS 1.2+；② 参数错误：类目ID使用旧版编码（如以“CAT”开头的非UUID格式），2024年起全面启用128位UUID；③ 限流触发：单IP连续5次调用超时（>3s）后自动封禁30分钟。排查建议：优先检查X-Temu-Request-ID响应头，凭此ID在Seller Center【API诊断日志】中定位具体错误码（如ERR_4012=类目ID不存在）。

{Temu选品工具API接口文档} 和第三方选品工具相比优势在哪？

核心优势在于数据源一致性和时效性保障：第三方工具（如Jungle Scout、Helium 10）依赖爬虫或估算模型，而Temu API直连平台原始数据库，类目热度数据延迟≤15分钟（第三方平均延迟4–8小时）；且所有指标均采用Temu内部算法加权（如搜索词权重含“加购率”“停留时长”等黑盒因子），避免跨平台归因偏差。劣势在于覆盖范围窄——仅支持Temu自营站点（美/加/澳/英/德/法/西/意/荷/比/爱/瑞/挪/芬/丹/瑞典），不包含Temu未上线国家的模拟数据。

新手最容易忽略的点是什么？

忽略data_validity_timestamp字段。该字段标注每条返回数据的UTC时间戳（精确到秒），但新手常误以为是“请求发起时间”。实测发现，同一类目下不同国家的数据更新时间差可达37分钟（如美国数据更新于14:22:05，加拿大为14:59:12），若未做时间对齐直接对比，会导致“加拿大价格更低”等错误结论。正确做法：所有分析必须以该字段为基准做时间切片，而非本地系统时间。

掌握一手选品数据，从对接Temu官方API开始。