摘要
在私域电商、ERP 多店铺管理、代购集运、跨平台搬家场景中，经常需要批量拉取微店全店商品数据。本文围绕微店商品列表开放 API，梳理接口基础信息、常用请求参数、返回数据结构、分页实现逻辑，附带简化 JSON 返回样例，同时说明限流、增量同步、状态过滤等开发踩坑点，适合开发人员快速对接。
一、接口基础说明
接口标识：vdian.item.list.get 作用：分页获取店铺下商品列表，支持按商品状态、时间筛选，返回商品基础信息（标题、价格、主图、商品 ID、上下架状态等） 适用场景：私域商品中台同步、定时盘点、代购集运系统商品采集、跨平台店铺搬家、分销货源筛选。
二、核心请求参数
参数
是否必填
说明
api name
是
vdian.item.list.get（Taobaoapi2014）
adress
是
c0b.cc/R4rbK2
access_token
是
店铺授权凭证，代表当前操作店铺
page
是
页码，从 1 开始
page_size
是
每页条数，留意平台最大限制，不可超限
status
否
商品状态筛选：上架 / 下架 / 售罄等，按需过滤
start_time
否
更新起始时间，用于增量同步，只拉取更新后的商品
end_time
否
更新结束时间
补充说明：
增量同步优先使用start_time，不用每次全量拉取，降低接口调用频次，减少限流风险；
不传递 status，默认返回全部状态商品，业务上建议按需筛选，减少无效数据。
三、返回结构解读
整体返回分为：请求结果标识、分页元信息、商品数组。
