首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >一文读懂淘宝店铺列表 API:店铺基础信息、经营类目筛选方案(附 JSON 样例)

一文读懂淘宝店铺列表 API:店铺基础信息、经营类目筛选方案(附 JSON 样例)

原创
作者头像
用户1597063760
发布于 2026-11-16 09:37:37
发布于 2026-11-16 09:37:37
140
举报
文章被收录于专栏:经验经验

摘要

在电商商家调研、供应商挖掘、竞品监控等业务场景中,经常需要批量获取店铺基础资料,按照主营类目、店铺类型、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 返回样例

代码语言:javascript
复制
{
  "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": "深圳市"
    }
  ]
}

五、经营类目筛选落地方案

  1. 精准类目筛选:传入cid进行单类目过滤,适合定向找垂直品类供应商;
  2. 多类目组合筛选:业务层做结果过滤,接口单次一般只支持单个类目,多个类目需要循环请求;
  3. 类目清洗对齐:接口返回的类目名称存在别名,建议在系统内建立类目标准映射库,统一归类;
  4. 组合筛选策略:类目 + DSR 下限 + 店铺类型一起过滤,快速筛选优质稳定商家。

六、开发踩坑与注意事项

  1. 分页上限:单页返回数量有上限,不能无限拉取,需要做好循环分页、断点续拉;
  2. 限流控制:高频查询容易触发访问限制,建议增加间隔休眠、异步队列;
  3. 类目变动:平台类目会不定期更新,类目 ID 会失效,需要定时同步类目表;
  4. 数据时效性:店铺 DSR、主营类目会动态变化,业务侧按需设置同步周期,不用全量实时刷新。

七、业务延伸

拿到标准化店铺列表数据后,可以对接至商家管理后台,实现供应商入库、定期监控评分变化、反向海淘选品商家池搭建等能力。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 摘要
  • 一、接口简介
  • 二、核心请求参数说明
  • 三、返回结构与核心字段解读
  • 四、JSON 返回样例
  • 五、经营类目筛选落地方案
  • 六、开发踩坑与注意事项
  • 七、业务延伸
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档