一、文章主题
《淘宝店铺所有商品 API:Python 一键拉取全店商品,结构化 JSON 解析》
二、核心内容(简洁落地版)
1. 为什么要用淘宝店铺商品 API?
批量获取店铺在售 / 全部商品,包括标题、价格、SKU、库存、主图等核心信息
替代手动爬虫,稳定、合规、无需破解平台反爬
适用于店铺运营、竞品分析、ERP 系统同步
2. 核心接口介绍
表格
| 接口名称 | 核心能力 | 适用场景 |
|---|---|---|
taobao.shop.get.items | 按店铺账号获取全量商品 | 商家自有店铺,精准拉取全店商品 |
taobao.items.search | 按关键词 / 店铺 ID 搜索商品 | 非商家授权,获取竞品店铺指定商品 |
taobao.items.list.get | 批量获取商品详情 | 已知商品 ID,批量查询详细信息 |
3. 前置准备
登录淘宝开放平台(https://open.taobao.com/),完成实名认证
创建应用,获取 AppKey、AppSecret
申请接口权限(搜索
taobao.shop.get.items等)商家专属接口需获取access_token(店铺授权)
4. 极简 Python 调用代码(核心示例)
python
运行
import requestsimport timeimport hashlib# 配置信息(替换为自己的)APP_KEY = "你的AppKey"APP_SECRET = "你的AppSecret"ACCESS_TOKEN = "你的access_token"SHOP_NICK = "目标店铺账号昵称" # 如:xx旗舰店API_URL = "https://shopapi.taobao.com/router/rest"def generate_sign(params):
"""生成API签名"""
sorted_params = sorted(params.items())
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()def get_shop_items(page_no=1, page_size=200):
"""获取店铺商品列表"""
params = {
"method": "taobao.shop.get.items",
"app_key": APP_KEY,
"session": ACCESS_TOKEN,
"nick": SHOP_NICK,
"page_no": page_no,
"page_size": page_size,
"status": "onsale", # onsale=在售,all=全部
"fields": "num_iid,title,price,stock,volume,pic_url",
"format": "json",
"v": "2.0",
"sign_method": "md5",
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S")
}
params["sign"] = generate_sign(params)
resp = requests.post(API_URL, data=params)
return resp.json()# 调用示例if __name__ == "__main__":
data = get_shop_items()
# 解析商品数据
items = data.get("taobao_shop_get_items_response", {}).get("result", {}).get("items", {}).get("item", [])
for item in items:
print(f"商品ID: {item['num_iid']}, 标题: {item['title']}, 价格: {item['price']}")5. 关键字段说明
num_iid:商品唯一 IDtitle:商品标题price:售价stock:库存(商家接口返回真实库存)volume:销量pic_url:主图链接sku:SKU 规格信息(需单独请求接口)
6. 避坑要点
控制频率:1 秒 1 次,避免触发限流(错误码:429/10003)
权限核对:确保已申请对应接口权限,否则报 403 错误
字段优化:
fields指定需要的字段,提升响应速度分页处理:循环获取
page_no,直到商品列表为空
三、适用场景总结
商家:同步全店商品至 ERP 系统,实现库存、价格统一管理
运营 / 选品:采集竞品店铺商品,分析价格策略、SKU 布局
开发者:快速搭建电商数据工具,实现多平台商品整合
四、快速落地步骤
完成开放平台权限申请
替换代码中的 AppKey、AppSecret、access_token、店铺昵称
运行代码,获取全店商品 JSON 数据
按需解析字段,保存至文件或数据库