淘宝店铺所有商品 API 接口：核心能力与数据返回参考

前言

主题

简洁解析淘宝店铺商品 API（含自有 / 全店商品获取），覆盖核心接口、调用要点及标准化 JSON 返回示例，助力快速实现店铺商品数据的合规采集与管理。

一、核心接口概述

淘宝开放平台提供两类核心接口，适配不同场景获取店铺商品：

taobao.items.onsale.get（自有店铺在售商品）
- 功能：获取授权店铺在售中商品，含库存、状态等敏感数据。
- 场景：商家 ERP、自有店铺商品同步、库存管理。
- 权限：需店铺授权（session），仅可查自身店铺。
taobao.item_search_shop（任意店铺公开商品）
- 功能：通过卖家 ID（seller_id）获取任意店铺公开在售商品，无敏感数据。
- 场景：竞品监控、公开商品数据分析、跨店商品展示。
- 权限：无需店铺授权，仅返回公开字段。

二、关键请求参数（极简版）

1. taobao.items.onsale.get（自有店铺）

表格

参数	是否必传	说明
session	是	店铺授权 token
page_no	否	页码，默认 1
page_size	否	每页条数，最大 100
status	否	商品状态：onsale（在售）/all（全部）

2. taobao.item_search_shop（任意店铺）

表格

参数	是否必传	说明
seller_id	是	卖家唯一 ID
page	否	页码，默认 1
page_size	否	每页条数，最大 100
sort	否	排序：new（新品）/sale（销量）/bid（价格升序）

三、JSON 数据返回参考（脱敏极简版）

1. 自有店铺（taobao.items.onsale.get）

json

复制代码

{
  "taobao_items_onsale_get_response": {
    "code": 200,
    "msg": "success",
    "total_results": 156,
    "page_no": 1,
    "page_size": 2,
    "items": {
      "item": [
        {
          "num_iid": "123456789012",
          "title": "2026夏季新款纯棉T恤",
          "price": "59.90",
          "original_price": "99.00",
          "stock": 200,
          "sales": 328,
          "pic_url": "https://img.alicdn.com/xxx.jpg",
          "detail_url": "https://item.taobao.com/item.htm?id=123456789012",
          "status": "onsale",
          "created_time": "2026-01-15 10:30:00"
        },
        {
          "num_iid": "123456789013",
          "title": "透气休闲运动鞋",
          "price": "129.00",
          "original_price": "199.00",
          "stock": 89,
          "sales": 156,
          "pic_url": "https://img.alicdn.com/yyy.jpg",
          "detail_url": "https://item.taobao.com/item.htm?id=123456789013",
          "status": "onsale",
          "created_time": "2026-02-20 14:15:00"
        }
      ]
    },
    "request_id": "abc123456789"
  }
}

2. 任意店铺（taobao.item_search_shop）

json

复制代码

{
  "item_search_shop_response": {
    "code": 200,
    "msg": "success",
    "seller_id": "987654321",
    "total_results": 89,
    "page": 1,
    "page_size": 2,
    "items": {
      "item": [
        {
          "num_iid": "456789012345",
          "title": "简约百搭牛仔外套",
          "price": "89.00",
          "sales": 520,
          "pic_url": "https://img.alicdn.com/zzz.jpg",
          "detail_url": "https://item.taobao.com/item.htm?id=456789012345",
          "shop_title": "XX服饰旗舰店"
        }
      ]
    }
  }
}

四、核心字段说明

基础标识：num_iid（商品唯一 ID）、seller_id/shop_id（店铺标识）。
商品核心：title（标题）、price（售价）、original_price（原价）、sales（销量）。
媒体信息：pic_url（主图 URL）、detail_url（商品详情页链接）。
状态数据：stock（库存，自有店铺接口返回）、status（商品状态）。

五、调用稳定性简要提示

合规优先：自有店铺接口需授权，禁止越权获取非自有店铺敏感数据。
频率控制：QPS≤5，分页间隔≥200ms，限流（429）时指数退避重试。
数据缓存：结果缓存 10 分钟，减少无效调用；增量数据用修改时间筛选。

要不要我给你一段可直接运行的 Python 极简调用示例（含签名、重试、缓存）？