淘宝店铺所有商品接口

获取淘宝店铺所有商品，核心依赖 淘宝开放平台（TOP） 的官方 API。以下是最常用、最稳定的接口清单与使用说明：

一、核心商品列表接口（获取全店商品）

1. taobao.items.onsale.get（官方首选）

功能：获取 ** 当前用户自己店铺 **** 出售中（上架）** 的商品列表。

适用：商家 ERP、商品管理、自有店铺数据同步（需店铺授权）。

关键字段返回：商品 ID (num_iid)、标题、价格、销量、主图、创建时间、修改时间。

关键参数

page_no: 页码（默认 1）

page_size: 每页条数（最大 100）

start_modified / end_modified: 按修改时间筛选增量数据

2. taobao.items.inventory.get

功能：获取 ** 当前用户自己店铺 **** 仓库中（下架 / 库存）** 的商品列表。

适用：下架商品管理、库存盘点。

3. taobao.item_search_shop（第三方 / 公开查询）

功能：通过 seller_id（卖家 ID）获取任意店铺的公开上架商品列表。

适用：竞品分析、商品采集、跨店数据展示。

注意：返回数据为公开信息，不含库存、成本、商家编码等敏感字段。

二、常用配套接口（完整业务链）

表格

接口名称	功能	场景
taobao.item.seller.get	获取单个商品的卖家完整详情（含 SKU、库存、商家编码）	商品详情页、批量更新
taobao.item.get	获取单个商品的公开详情	商品展示、价格监控
taobao.skus.custom.get	根据商家编码，批量查询商品 SKU 信息	库存同步、订单发货

三、调用前提（必须）

注册开发者：登录，完成企业 / 个人认证。

创建应用：获取 App Key 和 App Secret。

权限申请：

自有店铺：申请商家权限，需店铺账号授权。

第三方店铺：仅能调用公开接口（如 item_search_shop）。

签名机制：所有请求需按 TOP 规则生成 sign 签名（MD5 加密）。

四、获取全店商品步骤（示例）

调用 taobao.items.onsale.get，传入 page_no=1&page_size=100。

获取返回结果中的 total_results（总商品数），计算总页数。

循环分页调用，直到获取所有页数据。

如需详情，遍历商品 ID，调用 taobao.item.seller.get 获取全量信息。

五、常见限制

频率限制：企业应用默认 10000 次 / 分钟。

数据范围：自有店铺接口可查全量；第三方接口仅返回公开字段。

淘宝开放平台

File

审核编辑 黄宇