淘宝店铺所有商品API接口实战指南

一、核心接口与功能

核心接口 ：taobao.item_search_shop
- 功能：通过店铺唯一标识（seller_id/店铺ID）批量获取店铺内所有上架商品数据，支持分页、排序及字段定制。
- 数据范围：商品ID、标题、价格、销量、库存、主图、类目、SKU详情、运费模板等核心字段。
- 适用场景：电商ERP系统对接、竞品监控、店铺运营看板、商品聚合展示等。

二、接入全流程

账号与权限准备
- 注册开放平台：访问淘宝开放平台，完成个人/企业实名认证。
- 创建应用 ：在开发者控制台创建应用，获取App Key（应用标识）和App Secret（密钥，需严格保密）。
- 申请接口权限 ：在应用管理页面申请taobao.item_search_shop接口权限，审核通过后生效。

签名生成规则

步骤：
- 收集所有请求参数（公共参数+业务参数），排除sign本身。
- 按参数名ASCII码升序排序，拼接为key1value1key2value2...格式。
- 在拼接字符串首尾添加App Secret，形成app_secret+拼接字符串+app_secret。
- 使用MD5/HMAC-SHA256算法计算摘要，转为大写即为sign值。

示例代码（Python） ：

复制代码

python

复制代码

`import hashlib
import hmac
import time

def generate_sign(params, app_secret, sign_method='md5'):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = ''.join(f'{k}{v}' for k, v in sorted_params)
    sign_str = f"{app_secret}{param_str}{app_secret}"
    if sign_method == 'hmac-sha256':
        return hmac.new(app_secret.encode('utf-8'), sign_str.encode('utf-8'), hashlib.sha256).hexdigest().upper()
    else:
        return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
`

请求构造与发送

公共参数 ：app_key、method（固定为taobao.item_search_shop）、timestamp、v（API版本，默认2.0）、format（JSON/XML）、sign。
业务参数 ：
- seller_id（店铺卖家ID，可从店铺首页链接或商品详情页提取）。
- page（分页页码，默认1，最大100页）。
- page_size（每页数量，默认40，最大60条）。
- sort（排序方式：new新品优先、bid价格升序、bid_价格降序、sale销量降序）。
- fields（返回字段列表，如title,price,pic_url,item_desc）。

请求示例（Python） ：

复制代码

python

复制代码

`import requests
from urllib.parse import urlencode

app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
seller_id = "123456789"
params = {
    "method": "taobao.item_search_shop",
    "app_key": app_key,
    "timestamp": "2025-01-23 10:30:00",
    "v": "2.0",
    "format": "json",
    "sign_method": "hmac-sha256",
    "seller_id": seller_id,
    "page": 1,
    "page_size": 40,
    "sort": "sale",
    "fields": "num_iid,title,price,pic_url,sell_count"
}
params["sign"] = generate_sign(params, app_secret, "hmac-sha256")
response = requests.get("https://eco.taobao.com/router/rest", params=params)
print(response.json())
`

响应处理与分页
- 成功响应 ：解析item_search_shop_response→items→item中的商品列表，结合total_results字段计算总页数，循环调用获取全量数据。
- 错误处理 ：检查error_response字段，定位错误码（如15权限不足、40调用超限）并处理。

三、关键注意事项

权限与频率限制 ：
- 个人/企业开发者均可申请，但企业账号权限更高。
- 免费版单日调用上限1000次，超出需升级套餐或优化请求策略。
数据合规 ：
- 敏感字段（如用户信息）需AES-256加密，遵循《淘宝API数据使用规范》。
- 避免泄露App Secret，禁止在客户端代码中硬编码密钥。
性能优化 ：
- 使用本地缓存（如Redis）减少重复调用。
- 异步任务（如Celery）处理批量请求，避免阻塞主线程。
- 监控接口响应时间（通常<100ms），设置超时重试机制。

四、实战案例

竞品分析 ：某3C品牌通过taobao.item_search_shop抓取TOP5竞品店铺商品，分析价格区间与销量关系，优化新品定价策略，ROI提升40%。
库存预警 ：结合taobao.item.get接口实时同步库存数据，设置阈值（日均销量×1.5）触发预警，避免超卖。

五、资源与工具

官方文档：淘宝开放平台API文档
沙箱环境：淘宝沙箱测试
代码库：淘宝SDK-Python
调试工具：Postman、淘宝开发者论坛、阿里云开发者社区

通过以上步骤，开发者可快速实现淘宝店铺商品数据的批量获取与同步，支撑电商精细化运营与数据分析需求。