一、接口概述
淘宝开放平台提供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)。
- 数据分析:将获取的商品数据存入数据库,进行销量趋势分析、价格监控等。
通过以上方法,可高效获取淘宝店铺全量商品数据,满足业务需求。