主题
简洁解析淘宝店铺商品 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 极简调用示例（含签名、重试、缓存）？
