淘宝 item_search_shop（店铺商品全量）接口完整规范：功能、参数、返回字段、分页全量、调用示例、合规与风控
一、接口核心信息
- 接口名：taobao.item_search_shop_pro（第三方通用标准名，官方无同名公开接口，多为第三方封装 / 开放平台权限接口）
- 核心功能：按 seller_id/shop_id 获取店铺全量上架商品，支持分页、字段筛选、类目过滤
- 适用场景：店铺商品同步、竞品监控、ERP / 选品、数据报表
- 请求方式：GET/POST
- 数据范围：仅返回在售 (onsale) 商品；下架 / 删除 / 预售需额外接口
- 官方 vs 第三方：
- 官方开放平台：需企业认证、应用权限、seller 授权，接口为
taobao.items.onsale.get（仅自家店铺） - 第三方（如万邦、API 平台）：
item_search_shop_pro，支持任意公开店铺全量抓取，无需店铺授权
二、完整请求参数（必选 + 可选）
公共测试参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | String | 是 | API 密钥 / Token | your_app_key |
| secret | String | 是 | 签名密钥 | your_app_secret |
| method | String | 是 | 固定值 | taobao.item_search_shop |
| format | String | 否 | 返回格式，默认 json | json |
| v | String | 否 | 版本，默认 2.0 | 2.0 |
如何获取 seller_id/shop_id
- 店铺首页 URL：https://shopxxx.taobao.com → shop_id=xxx
- 商品详情页：F12 / 源码搜
sellerId或userNumId - 第三方工具 / 接口直接解析
商品 items 核心字段（全量明细）
| 字段名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| num_iid | String | 商品唯一 ID（主键） | 583975606695 |
| title | String | 商品标题 | 华为 Mate60 Pro 5G 手机 |
| price | Float | 现价（促销价） | 5999.00 |
| original_price | Float | 划线价 / 原价 | 6999.00 |
| sales | Int | 总销量 | 12000 |
| volume | Int | 月销量 | 3000 |
| pic_url | String | 主图 URL | https://img.alicdn.com/xxx.jpg |
| item_imgs | Array | 多图列表（最多 5 张） | ["https://...1.jpg",...] |
| detail_url | String | 商品详情链接 | https://item.taobao.com/item.htm?id=xxx |
| category_id | String | 类目 ID | 50012081 |
| category_name | String | 类目名称 | 3C 数码 / 手机 |
| location | String | 发货地 | 广东 深圳 |
| post_fee | Float | 运费（0 = 包邮） | 0.00 |
| is_on_sale | Bool | 是否在售 | true |
| seller_nick | String | 卖家昵称 | XX 数码旗舰店 |
| shop_title | String | 店铺名 | XX 旗舰店 |
| props | Array | 规格属性 | [{"name":"颜色","value":"黑色"},...] |
| sku | Array | SKU 信息（部分平台返回） | 规格、价格、库存 |
三、全量获取店铺商品（分页遍历逻辑）
核心步骤（必做）
- 第 1 页请求：page=1，page_size=40，获取
total_results和page_count - 循环遍历：page 从 2 到 page_count，依次请求
- 合并所有 items 数组，得到店铺全量商品列表
- 风控控制：每页间隔 1-3 秒，单 IP≤50 次 / 分钟
全量示例（Python ）
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
# 封装好API demo url=o0b.cn/ibrad 复制链接获取测试
url = "https://api-gw.cn/taobao/item_search_shop_pro/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&shop_id=440688975&seller_id=4273827547&page=1&sort="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)四、总结
taobao.item_search_shop_pro接口为店铺全量商品数据获取提供了标准化、合规化的解决方案，其核心在于掌握签名生成规则、权限申请流程与分页遍历逻辑。通过本文的技术解析与实战示例，开发者可快速完成接口对接，实现商品数据的高效同步。在实际开发中，需重点关注签名正确性、调用频率控制与数据合规性，避免常见错误，确保接口稳定运行.
