一、接口概述
1688 商品列表 API，属于 1688 开放平台提供的数据接口，用于批量获取店铺内商品清单，可返回商品 ID、标题、主图、价格、库存、上架状态等基础商品信息。
1688.item_search的定位是搜索型接口，通过关键词或类目 ID 返回 1688 批发商品列表摘要 。它和商品详情接口是互补关系：列表接口负责 "找商品"，详情接口负责 "拿完整数据"。
接口名称：1688.product.search （Taobaoapi2014前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
接口版本：2.0
核心能力：关键词检索，支持价格区间、起订量、地区、实力商家、发货能力等多维度过滤，返回商品标题、阶梯批发价、MOQ、供应商信息、30 天成交、诚信通资质等 B2B 批发字段。
适用场景
- 跨境电商系统：批量拉取 1688 货源，同步到 Ozon、Temu 等平台刊登
- 供应链比价：定时抓取店铺商品，监控价格、上下架变动
- 商品库存监控：批量获取在售商品库存状态，自动预警缺货产品
- 竞品调研：采集同行店铺商品清单，做品类与定价分析
二、基础请求参数说明
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| shopId | 是 | 1688 店铺 ID |
| pageNum | 是 | 页码，从 1 开始 |
| pageSize | 是 | 每页条数，参考上限一般 50，以官方文档为准 |
| status | 否 | 商品状态：在售 / 下架 / 全部 |
| appKey | 是 | 开放平台应用密钥 |
| timestamp | 是 | 请求时间戳 |
| sign | 是 | 请求签名 |
三、返回数据结构说明
接口返回 JSON 结构，顶层包含请求状态码、消息、总条数、总页数、当前页商品数组。 商品数组内每个元素为单品对象，核心字段：
- itemId：商品 ID
- title：商品标题
- picUrl：商品主图地址
- price：商品价格区间
- stock：库存数量
- saleCount：销量
- status：商品上下架状态
- categoryName：类目名称
