taobao.item_search_shop是专门用于按店铺维度批量拉取全量商品的接口，可实现一键采集指定淘宝店铺所有上架商品的需求，以下是完整的使用指南。
一、接口核心能力与适用场景
核心功能：通过店铺唯一标识批量获取店铺内所有在售商品数据，支持分页、排序及返回字段定制。
覆盖核心字段：包含商品ID、标题、价格、销量、主图、类目、SKU详情、运费模板等全维度商品信息。
适用场景：电商ERP系统对接、竞品全量监控、店铺运营数据看板、跨平台商品聚合展示等。
二、前置接入准备
账号与应用创建：访问淘宝开放平台，完成个人/企业实名认证，在开发者控制台创建应用，获取App Key和App Secret并妥善保管。
接口权限申请：在应用管理页面提交业务场景说明，申请taobao.item_search_shop接口调用权限，等待平台审核通过后生效。
获取店铺标识：从目标店铺首页URL中提取shop_id，或在商品详情页源码中搜索sellerId/userNumId得到卖家ID，作为接口的核心业务入参。
三、签名生成规则
淘宝API采用标准MD5/HMAC-SHA256签名机制，步骤如下：
收集所有请求参数（公共参数+业务参数），排除sign本身。
按参数名ASCII码升序排序，拼接为key1value1key2value2的连续字符串。
在拼接字符串首尾添加App Secret，形成完整签名源串。
使用指定加密算法计算摘要，转为大写后即为最终sign参数值。
四、完整请求参数说明
表格
参数名 类型 必填 说明 示例
method String 是 固定接口方法名 taobao.item_search_shop
app_key String 是 应用标识 your_app_key
timestamp String 是 当前东八区时间戳，与平台时差不超过5分钟 2026-08-10 15:30:00
v String 否 API版本，默认2.0 2.0
format String 否 返回格式，默认json json
seller_id String 是 目标店铺卖家ID 123456789
page Int 否 分页页码，默认1，最大支持100页 1
page_size Int 否 单页返回条数，默认40，最大60条 40
sort String 否 排序规则，支持新品/价格/销量排序 sale（销量降序）
fields String 否 指定返回字段列表 num_iid,title,price,pic_url
五、Python调用示例
python
import hashlib
import requests
from urllib.parse import urlencode
def generate_sign(params, app_secret, sign_method='md5'):
sorted_params = sorted(params.items(), key=lambda x: x)
param_str = ''.join(f'{k}{v}' for k, v in sorted_params)
sign_str = f"{app_secret}{param_str}{app_secret}"
return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
# 配置基础信息
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
seller_id = "TARGET_SHOP_SELLER_ID"
# 构造请求参数
params = {
"method": "taobao.item_search_shop",
"app_key": app_key,
"timestamp": "2026-08-10 15:30:00",
"v": "2.0",
"format": "json",
"seller_id": seller_id,
"page": 1,
"page_size": 40,
"sort": "sale",
"fields": "num_iid,title,price,pic_url,sales"
}
# 生成签名并发送请求
params["sign"] = generate_sign(params, app_secret)
response = requests.get("https://gw.api.taobao.com/router/rest", params=params)
print(response.json())
六、全量采集与异常处理
分页拉取全量数据：从响应的total_results字段获取店铺商品总数，计算总页数后循环遍历分页参数，逐页调用接口拼接所有商品数据。
常见错误码排查：
错误码15：接口权限未申请或审核未通过
错误码40：请求频率超出平台限制，需降低调用间隔
错误码41：签名生成逻辑错误，需重新校验参数排序规则
合规注意事项：2026年淘宝平台已封堵非官方的违规采集脚本，使用官方API接口可规避风控预警，聚石塔内调用的计费成本远低于外部，基础API仅需0.02元/百次调用。
需要我为你提供可直接运行的全量数据采集脚本，帮你快速完成店铺全商品批量导出吗？
