淘宝店铺所有商品 API 接口实战指南

主题

一、接口简介

• taobao.items.onsale.get：获取在售商品

• taobao.items.inventory.get：获取仓库商品

• taobao.item.get：获取单商品详情

二、调用准备

1. 登录淘宝开放平台，完成实名认证

2. 创建应用，获取 AppKey、AppSecret

3. 申请对应接口权限

4. 获取店铺授权 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 拉取全店

四、频率限制

• 个人开发者：≤2 QPS、30 次 / 分钟、日限约 1000 次

• 企业开发者：≤50 QPS、300 次 / 分钟、可工单提额

• 触发限流返回 429，建议加 time.sleep(1) 稳调用

五、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"
        }
      ]
    }
  }}

六、常见问题

1. 401/403：权限不足或 Token 失效

2. 429：调用频率超限，降低请求速度

3. 无数据：店铺昵称错误、page_no 超出范围

4. 字段为空：fields 未指定或无权限

七、总结