
在电商商家调研、供应商挖掘、竞品监控等业务场景中,经常需要批量获取店铺基础资料,按照主营类目、店铺类型、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 需要提前维护类目映射表;不同店铺类型的筛选参数取值不一样,需要做参数兼容。
返回数据整体分为分页信息、店铺数组两大部分。重点字段:
{
"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": "深圳市"
}
]
}拿到标准化店铺列表数据后,可以对接至商家管理后台,实现供应商入库、定期监控评分变化、反向海淘选品商家池搭建等能力。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。