某宝店铺商品全量接口-item_search_shop_pro

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