一、接口概述
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：类目名称
