淘宝商品详情 API(taobao.item.get)采用 ** 日总量 + 分钟级(QPM) + 秒级(QPS)** 三重限流,不同开发者身份的默认限制如下(2026 年最新):
一、默认调用频率限制(taobao.item.get)
表格
| 开发者身份 | 日调用上限 | 分钟级限流(QPM) | 秒级限流(QPS) | 备注 |
|---|---|---|---|---|
| 个人开发者(免费) | 500--1000 次 / 天 | 10--30 次 / 分钟 | ≤2 次 / 秒 | 新应用默认额度 |
| 企业开发者(认证) | 1000--5000 次 / 天 | 100--300 次 / 分钟 | 5--50 次 / 秒 | 初始额度,可申请提额 |
| 服务商 / 企业套餐 | 10 万--100 万 次 / 天 | 500--3000 次 / 分钟 | 最高 500 次 / 秒 | 需服务商认证 + 保证金 |
二、限流核心规则
- 三重限制同时生效:必须同时满足日、分钟、秒级限制,任一超限都会触发限流。
- 限流维度 :按AppKey维度限流,同一 AppKey 下所有请求共享额度。
- 错误标识 :超限返回429 错误码,
sub_code为isv.api-rate-limit-exceeded。 - 可调整性:企业 / 服务商可通过淘宝开放平台工单申请提升额度。
三、实用调用建议(避免限流)
- 控制速度:按上限的 **80%** 设置调用速度(如个人≤1.6 QPS、企业≤40 QPS),预留缓冲。
- 批量优化 :非实时场景用
taobao.items.list.get批量接口,减少请求次数。 - 错峰调用 :批量同步任务安排在凌晨 0-6 点低峰期。
- 缓存策略:热门商品用 Redis 缓存(有效期 5-10 分钟),避免重复请求。
- 重试机制 :限流后采用指数退避(等待 1s→2s→4s)重试,最多 3 次。