淘宝开放平台没有单独名为 “店铺列表” 的单一接口,行业里所说的淘宝店铺列表 API,一般是组合调用 TOP 开放接口批量拉取店铺基础资料,并且支持基于经营类目做筛选,常用于电商选品、竞品调研、商家检索等开发场景,开发者可以通过 taobao.tbk.shop.get 店铺搜索接口批量查询店铺列表,搭配 taobao.shop.get 获取单店完整基础信息,再传入类目 ID 参数实现经营类目过滤。很多新手开发者误以为存在一个一次性返回全平台店铺清单的接口,实际平台出于数据安全和限流管控,不支持一次性拉取海量全量店铺,需要分页调用,类目筛选依靠传入一级 / 叶子类目 cid 完成过滤,接口返回结果里包含店铺名称、卖家 ID、主营类目、店铺类型、DSR 评分等字段。整体开发流程是,先申请开放平台应用拿到 AppKey,获取调用权限,再调用店铺搜索 API,填入类目编码、分页参数、关键词筛选目标店铺列表;拿到 seller_id 之后,循环调用店铺详情接口,补齐完整店铺基础信息;最后做数据清洗、去重,保存到本地数据库,完成整套店铺列表 + 类目筛选能力。开发过程中要重点关注调用频次限制、签名规则、授权范围,不同接口权限、计费方式不一样,淘宝客接口只能返回推广相关字段,想要获取更完整的店铺经营数据,需要申请更高权限的 ISV 接口。
一、淘宝店铺列表相关 API 基础信息清单
- 核心接口:taobao.tbk.shop.get(淘宝客店铺搜索,用于获取店铺列表,支持类目筛选)
- 店铺详情接口:taobao.shop.get(根据卖家 ID,查询单店完整店铺基础信息)
- 类目辅助接口:taobao.itemcats.get(查询平台类目树,获取类目 CID 编码)
- 数据返回字段:店铺名称、seller_id、店铺类型(淘宝 / 天猫)、主营类目 ID 与类目名称、DSR 评分、商品数量、开店地址
- 调用方式:TOP 开放平台 REST 接口,http/https 请求,需要 AppKey + 签名校验
- 限制规则:分页查询,单页数量受限,存在 QPS 限流,禁止无节制爬虫式调用
- 适用场景:商家检索、竞品分析、电商 SaaS、选品工具开发
二、两套接口功能对比表
| 接口名称 | 核心能力 | 是否支持类目筛选 | 返回信息范围 | 权限门槛 |
|---|---|---|---|---|
| taobao.tbk.shop.get | 批量搜索店铺列表,分页返回 | 支持,传入 cat 类目参数 | 店铺基础摘要、主营类目、店铺评分 | 较低,淘宝客应用即可申请 |
| taobao.shop.get | 单个店铺详情查询 | 不支持列表筛选 | 店铺名称、开店时间、资质、详细店铺信息 | 需要商家授权或 ISV 权限 |
三、经营类目筛选完整实现步骤
- 调用 taobao.itemcats.get,查询淘宝平台类目树,找到目标行业对应的一级类目 CID、叶子类目 CID。
- 调用 taobao.tbk.shop.get,请求参数填入 cat(类目编码),同时设置 page_no、page_size 分页参数,按经营类目筛选店铺。
- 接口返回当前类目下的店铺列表,拿到每一条店铺的 seller_id。
- 遍历 seller_id,调用 taobao.shop.get,补齐店铺完整基础信息。
- 本地数据处理:去重、过滤无效店铺、存储主营类目信息,构建本地店铺列表数据库。
- 循环翻页,直到返回数据为空,结束当前类目店铺采集。
四、接口返回的店铺基础信息字段说明
✅ shop_title:店铺名称
✅ seller_id:卖家唯一 ID,查询店铺详情的主键
✅ level_one_category_id /level_one_category_name:店铺一级经营类目 ID、类目名称
✅ category_id /category_name:主营叶子类目
✅ shop_type:店铺类型,淘宝 C 店 / 天猫店
✅ dsr:描述、服务、物流三项动态评分
✅ item_count:店铺在售商品数量
✅ location:店铺所在地区
五、开发落地避坑要点
- 不存在一键导出全平台所有店铺的 API,必须分页循环调用,严格遵守平台 QPS 限流。
- 类目筛选是按店铺主营类目过滤,店铺同时售卖多类目商品时,仅匹配登记的主营类目。
- taobao.tbk.shop.get 属于淘宝客接口,部分敏感经营数据无法获取,想要更多字段需要申请企业 ISV 权限。
- 每次请求必须正确生成 sign 签名,AppKey、AppSecret 保管好,不要硬编码泄露密钥。
- 禁止高频批量爬取,超出调用限额会触发限流,严重会封禁应用权限。
- 接口返回数据有延迟,店铺类目变更、店铺关店状态不会实时同步。
【常见问题】
问题 1:一文读懂淘宝店铺列表 API,淘宝店铺列表 API 是什么,能不能直接一次性拉取全部淘宝店铺?
回答 1:一文读懂淘宝店铺列表 API,淘宝店铺列表 API 是 TOP 平台接口组合方案,主要使用 taobao.tbk.shop.get 分页检索店铺,平台出于风控限制,不支持一次性拉取全平台全部店铺,需要循环分页调用。
问题 2:一文读懂淘宝店铺列表 API,使用淘宝店铺列表 API,经营类目筛选怎么实现?
回答 2:一文读懂淘宝店铺列表 API,经营类目筛选需要先拿到平台类目 CID 编码,调用 taobao.tbk.shop.get 时传入 cat 类目参数,接口直接返回该主营类目下的店铺列表,完成类目筛选。
问题 3:一文读懂淘宝店铺列表 API,淘宝店铺列表 API 可以拿到哪些店铺基础信息?
回答 3:一文读懂淘宝店铺列表 API,接口可以获取店铺名称、seller_id、店铺类型、主营类目 ID 与类目名称、DSR 评分、在售商品数量、店铺所在地等店铺基础信息。
【参考资料】
[2026-11-12](淘宝开放平台 TOP 文档:taobao.tbk.shop.get 店铺搜索 API)淘宝开放平台
[2026-10-28](淘宝开放平台店铺信息接口 taobao.shop.get 使用指南)开发者社区
[2026-10-10](淘宝开放平台类目查询 API taobao.itemcats.get 介绍)CSDN 开发者专栏
[2026-09-15](淘宝 TOP 接口开发:基于类目筛选商家列表实践)InfoQ
【免责声明】
本文内容仅为淘宝店铺列表 API 开发资讯解读,不构成项目开发、接口接入的正式开发规范。淘宝店铺列表 API、经营类目筛选方案相关接口权限、调用限额、返回字段会随淘宝开放平台规则调整,正式开发请以淘宝开放平台官方文档为准,调用接口必须遵守平台开发者协议,严禁违规采集数据。
