全部
常见问题
产品动态
精选推荐
功能建议

已处理 待处理 {{opt.name}}
已处理 待处理
分析中 已回复 待规划 {{opt.name}}
分析中 已回复 待规划
一文读懂淘宝店铺列表 API:店铺基础信息、经营类目筛选方案

管理 管理 编辑 删除

摘要

在电商商家调研、供应商挖掘、竞品监控等业务场景中,经常需要批量获取店铺基础资料,按照主营类目、店铺类型、DSR 评分等条件筛选目标商家。本文梳理淘宝店铺列表接口的核心请求参数、返回字段结构,讲解多维度筛选的实现思路,附带返回 JSON 样例,适合 ERP、供应链选品、商家池管理等系统开发参考。

一、接口简介

该接口主要用于按条件查询店铺列表,支持关键词、类目、店铺类型、评分区间等筛选,返回店铺名称、店铺 ID、主营类目、DSR、开店时间、信誉等级等基础信息。

适用场景:跨境货源供应商挖掘、竞品商家跟踪、商家库自动化搭建、供应链系统商家检索。

二、核心请求参数说明


参数说明
api_nametaobao.item_search_shop (Taobaoapi2014前往)
adressc0b.cc/R4rbK2
keyword店铺搜索关键词,支持店铺名称
cid类目 ID,指定主营类目筛选
shop_type店铺类型:天猫店 / 淘宝 C 店 / 企业店
start_dsr / end_dsrDSR 评分区间筛选
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、主营类目会动态变化,业务侧按需设置同步周期,不用全量实时刷新。

七、业务延伸

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


{{voteData.voteSum}} 人已参与
支持
反对
请登录后查看

用户19970108018 最后编辑于2026-11-16 11:27:14

快捷回复
{{replySubmitting ? '提交中...' : '回复'}}
{{replySubmitting ? '提交中...' : '回复'}}
回复({{post_count}}) {{!is_user ? '我的回复' :'全部回复'}}
排序 默认正序 回复倒序 点赞倒序

{{item.user_info.nickname ? item.user_info.nickname : item.user_name}} LV.{{ item.user_info.bbs_level || item.bbs_level }}

作者 管理员 企业

{{item.floor}}# 同步到gitee 已同步到gitee {{item.is_suggest == 1? '取消推荐': '推荐'}}
{{item.is_suggest == 1? '取消推荐': '推荐'}} 【已收集】
{{item.floor}}# 沙发 板凳 地板 {{item.floor}}# 【已收集】
{{item.user_info.title || '暂无简介'}}
附件

{{itemf.name}}

{{item.created_at}}  {{item.ip_address}}
打赏
已打赏¥{{item.reward_price}}
{{item.like_count}}
分享
{{item.showReply ? '取消回复' : '回复'}}
删除
{{replySubmitting ? '提交中...' : '回复'}}
{{replySubmitting ? '提交中...' : '回复'}}

{{itemc.user_info.nickname}}

{{itemc.user_name}}

回复 {{itemc.comment_user_info.nickname}}

附件

{{itemf.name}}

{{itemc.created_at}}
打赏
已打赏¥{{itemc.reward_price}}
{{itemc.like_count}}
{{itemc.showReply ? '取消回复' : '回复'}}
删除
{{replySubmitting ? '提交中...' : '回复'}}
{{replySubmitting ? '提交中...' : '回复'}}
收起 展开更多
查看更多
打赏
已打赏¥{{reward_price}}
28
{{like_count}}
{{collect_count}}
添加回复 ({{post_count}})

相关推荐

{{replySubmitting ? '提交中...' : '回复'}}
{{replySubmitting ? '提交中...' : '回复'}}
问题:
问题自动获取的帖子内容,不准确时需要手动修改. [获取答案]
答案:
提交
bug 需求 取 消 确 定
打赏金额
当前余额:¥{{rewardUserInfo.reward_price}}
{{item.price}}元
请输入 0.1-{{reward_max_price}} 范围内的数值
打赏成功
¥{{price}}
完成 确认打赏

微信登录/注册

{{ wechatLoginError }}
切换手机号登录

{{ bind_phone ? '绑定手机' : '手机登录'}}

{{codeText}}
切换微信登录/注册
暂不绑定
CRMEB客服
CRMEB咨询热线 400-8888-794

扫码领取产品资料

功能清单
思维导图
安装教程
CRMEB开源商城下载 源码下载 CRMEB帮助文档 帮助文档
返回顶部 返回顶部
CRMEB客服