一、接口概述
淘宝开放平台提供taobao.items.onsale.get/taobao.item_search_shop接口，可批量获取店铺在售商品列表，包含商品 ID、标题、价格、销量、图片等核心信息。该接口适用于商品库管理、竞品监控、数据分析等场景。
二、接口调用流程
1. 前期准备
- 注册账号：访问 c0b.cc/R4rbK2 完成注册。
- 创建应用：获取App Key和App Secret，用于身份验证。
- 申请权限：在应用管理中申请taobao.items.onsale.get接口权限。
2. 核心参数
| 参数名 | 说明 | 示例值 |
|---|---|---|
| nick | 卖家昵称（如 "店铺名称"） | "seller_nick" |
| page_no | 页码（从 1 开始） | 1 |
| page_size | 每页返回商品数（最大 200） | 100 |
| fields | 自定义返回字段（逗号分隔） | "num_iid,title,price" |
三、Python 代码示例
{
"user": {
"shop_id": "495784237",
"seller_id": "2750507712",
"nick": "欧阳晴739329154",
"shop_name": "中龙品牌家装卫浴建材",
"shop_url": "https://shop495784237.taobao.com/",
"score": [
{
"score_type": "experience",
"score": "4.4",
"socre_title": "综合体验"
},
{
"score_type": "goods",
"score": "4.4",
"socre_title": "宝贝质量"
},
{
"score_type": "logistics",
"score": "4.6",
"socre_title": "物流速度"
},
{
"score_type": "service",
"score": "4.2",
"socre_title": "服务保障"
}
],
"_ddf": "alex",
"grade_url": "//gtms01.alicdn.com/tps/i1/TB1yHn9HpXXXXaOXFXX3e.oIVXX-78-24.png",
"Logo_url": "https://img.alicdn.com/imgextra/i1/2750507712/O1CN01HNhNt526q9V3C5SrW_!!2750507712.jpg"
},
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today: max:15000 all[=++];expires:2031-01-01",
"execution_time": "2.339",
"server_time": "Beijing/2025-03-19 10:54:26",
"client_ip": "127.0.0.1",
"call_args": [
],
"api_type": "taobao",
"server_memory": "4.42MB",
"last_id": false
}
- 四、注意事项 权限与频率：
- 需申请taobao.items.onsale.get接口权限。
- 调用频率限制为100次/分钟，建议添加延迟（如time.sleep(1)）。
字段扩展：
- 通过fields参数可获取更多字段（如desc商品描述、sales销量）等。
异常处理：
- 添加重试机制（如 3 次重试）和错误日志记录。
- 处理网络超时、签名错误（40007）等问题。
数据安全：
- 敏感信息（如App Secret）需加密存储，避免泄露。
五、扩展应用
- 结合商品详情接口：通过taobao.item.get接口，传入num_iid获取单个商品的详细信息（如库存、SKU）。
- 数据分析：将获取的商品数据存入数据库，进行销量趋势分析、价格监控等。
通过以上方法，可高效获取淘宝店铺全量商品数据，满足业务需求。
