淘宝店铺所有商品 API 接口实战指南
主题
极简上手：淘宝店铺商品 API 调用、频率与数据返回全解
一、接口简介
淘宝店铺商品 API 用于批量获取店铺在售 / 仓库商品，支持标题、价格、库存、主图、销量、SKU 等数据，常用于 ERP 同步、竞品分析、商品库管理。
核心接口
taobao.items.onsale.get：获取在售商品taobao.items.inventory.get：获取仓库商品taobao.item.get：获取单商品详情
二、调用准备
登录淘宝开放平台，完成实名认证
创建应用，获取 AppKey、AppSecret
申请对应接口权限
获取店铺授权 Access Token
三、调用要点
请求方式：POST 提交到网关
https://eco.taobao.com/router/rest必传参数：method、app_key、session、fields、page_no、page_size、sign、timestamp
签名规则：参数按字典序排序，用 AppSecret 前后包裹，MD5 加密转大写
分页：page_size 最大 200，循环 page_no 拉取全店
四、频率限制
按 QPS（秒）+ QPM（分钟）+ 日总量 三重限流
个人开发者：≤2 QPS、30 次 / 分钟、日限约 1000 次
企业开发者：≤50 QPS、300 次 / 分钟、可工单提额
触发限流返回 429，建议加
time.sleep(1)稳调用
五、JSON 返回示例
json
{
"taobao_items_onsale_get_response": {
"code": 0,
"msg": "success",
"total_results": 156,
"page_no": 1,
"page_size": 100,
"items": {
"item": [
{
"num_iid": 123456789012,
"title": "商品标题",
"price": "99.00",
"stock": 200,
"volume": 1280,
"pic_url": "https://img.alicdn.com/xxx.jpg"
}
]
}
}}六、常见问题
401/403：权限不足或 Token 失效
429：调用频率超限，降低请求速度
无数据：店铺昵称错误、page_no 超出范围
字段为空：fields 未指定或无权限
七、总结
淘宝店铺商品 API 是商家与开发者高效获取商品数据的官方方案，做好权限申请、签名校验、频率控制、分页拉取，即可稳定获取全店商品数据。
