摘要
在电商商家调研、供应商挖掘、竞品监控等业务场景中,经常需要批量获取店铺基础资料,按照主营类目、店铺类型、DSR 评分等条件筛选目标商家。本文梳理淘宝店铺列表接口的核心请求参数、返回字段结构,讲解多维度筛选的实现思路,附带返回 JSON 样例,适合 ERP、供应链选品、商家池管理等系统开发参考。
一、接口简介
该接口主要用于按条件查询店铺列表,支持关键词、类目、店铺类型、评分区间等筛选,返回店铺名称、店铺 ID、主营类目、DSR、开店时间、信誉等级等基础信息。
适用场景:跨境货源供应商挖掘、竞品商家跟踪、商家库自动化搭建、供应链系统商家检索。
二、核心请求参数说明
| 参数 | 说明 |
|---|---|
| api_name | taobao.item_search_shop (Taobaoapi2014前往) |
| adress | c0b.cc/R4rbK2 |
| keyword | 店铺搜索关键词,支持店铺名称 |
| cid | 类目 ID,指定主营类目筛选 |
| shop_type | 店铺类型:天猫店 / 淘宝 C 店 / 企业店 |
| start_dsr / end_dsr | DSR 评分区间筛选 |
| page_no | 页码,分页起始页 |
| page_size | 单页条数,受接口限流限制 |
| sort | 排序方式,支持按开店时间、信誉排序 |
开发注意:类目 ID 需要提前维护类目映射表;不同店铺类型的筛选参数取值不一样,需要做参数兼容。
三、返回结构与核心字段解读
返回数据整体分为分页信息、店铺数组两大部分。重点字段:
- shop_id:店铺唯一标识,后续可用于查询店铺详情
- shop_name:店铺名称
- main_cid、main_category:主营类目 ID 与类目名称
- shop_type:店铺类型
- dsr:服务、物流、描述三项评分
- credit_level:店铺信誉等级
- open_time:店铺开业时间
- province、city:店铺所在地
四、JSON 返回样例
{
"total": 1256,
"page_no": 1,
"page_size": 20,
"shop_list": [
{
"shop_id": "1000862345",
"shop_name": "XX家居优选店",
"main_category": "家居收纳",
"main_cid": 50024689,
"shop_type": "cshop",
"dsr": {
"desc_score": 4.8,
"service_score": 4.7,
"logistics_score": 4.8
},
"credit_level": "4钻",
"open_time": "2021-03-15",
"province": "浙江省",
"city": "杭州市"
},
{
"shop_id": "1000975612",
"shop_name": "XX数码专营店",
"main_category": "3C数码配件",
"main_cid": 50008123,
"shop_type": "tmall",
"dsr": {
"desc_score": 4.9,
"service_score": 4.8,
"logistics_score": 4.9
},
"credit_level": "天猫旗舰店",
"open_time": "2019-11-02",
"province": "广东省",
"city": "深圳市"
}
]
}
五、经营类目筛选落地方案
精准类目筛选:传入cid进行单类目过滤,适合定向找垂直品类供应商;- 多类目组合筛选:业务层做结果过滤,接口单次一般只支持单个类目,多个类目需要循环请求;
- 类目清洗对齐:接口返回的类目名称存在别名,建议在系统内建立类目标准映射库,统一归类;
- 组合筛选策略:类目 + DSR 下限 + 店铺类型一起过滤,快速筛选优质稳定商家。
六、开发踩坑与注意事项
- 分页上限:单页返回数量有上限,不能无限拉取,需要做好循环分页、断点续拉;
- 限流控制:高频查询容易触发访问限制,建议增加间隔休眠、异步队列;
- 类目变动:平台类目会不定期更新,类目 ID 会失效,需要定时同步类目表;
- 数据时效性:店铺 DSR、主营类目会动态变化,业务侧按需设置同步周期,不用全量实时刷新。
七、业务延伸
拿到标准化店铺列表数据后,可以对接至商家管理后台,实现供应商入库、定期监控评分变化、反向海淘选品商家池搭建等能力。

