淘宝 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接口为店铺全量商品数据获取提供了标准化、合规化的解决方案，其核心在于掌握签名生成规则、权限申请流程与分页遍历逻辑。通过本文的技术解析与实战示例，开发者可快速完成接口对接，实现商品数据的高效同步。在实际开发中，需重点关注签名正确性、调用频率控制与数据合规性，避免常见错误，确保接口稳定运行.
