摘要
本文以 1688 开放平台商品搜索接口alibaba.product.search为核心，从接口基础介绍、关键词检索入参、筛选条件配置、分页实现逻辑、返回结果解析、开发踩坑几个维度做入门讲解，适合需要对接 B2B 货源采集、ERP 选品、供应链数据分析的开发人员阅读，附带基础调用思路与注意事项。
一、接口基础说明
接口名称：alibaba.product.search（Taobaoapi2014前往体验）
请求地址：c0b.cc/R4rbK2
能力：根据关键词，配合价格区间、起订量、产地、发货地、类目等筛选条件，批量查询 1688 批发商品列表，常用于货源挖掘、竞品监控、跨境铺货前置选品、ERP 货源同步场景。
二、关键词检索核心入参
关键词是搜索的核心，对应入参一般为q，是必填参数。
q：搜索关键词，和 1688 网页端搜索框输入内容一致，支持中文商品词，例如 “不锈钢水杯”“涤纶面料”；
配套基础入参：
cat_id：类目 ID，可选；指定类目后，关键词检索范围收敛，提升结果精准度；sort_type：排序方式，支持综合排序、销量从高到低、价格升序 / 降序、新品优先。
三、筛选条件配置（业务高频使用）
这是 B 端批发场景非常重要的能力，常用筛选参数：
价格区间：
price_start、price_end，筛选批发价范围；起订量：
min_order，筛选最小起订件数，跨境选品经常用到；发货地：
delivery_location，限定货源城市；是否实力商家、是否深度验厂、是否一件代发标识；
运费模式、是否支持 48 小时发货等服务标签筛选。
如果当前返回商品数组不为空，处理数据，page_no +=1，继续请求；
当商品列表为空 / 已经拉取到最大页码，终止循环。
重要坑点：
接口有最大分页上限，不是无限翻页；超过上限后再请求，返回空数据；
高频循环请求极易触发限流，必须增加请求间隔、本地缓存、失败重试机制；
翻页过程中商品实时变动，会出现重复商品或者商品消失，业务层需要做商品 ID 去重。
五、返回结果核心字段简述
返回 JSON 中比较常用的字段：
product_id：商品唯一 ID，后续可以传给商品详情接口拿到完整信息；subject：商品标题；price：批发参考价；min_order_num：最小起订量；pic_url：主图地址；sale_count：销量；company_name：供应商名称；cat_id：所属类目；tags：服务标签（一件代发、极速发货等）。
六、简易调用伪代码思路（Python）
七、开发避坑清单
权限问题：很多筛选字段、销量字段需要特定应用权限，测试前先看应用权限包；
限流：开放平台有 QPS 限制，批量拉取不要并发爆刷；
数据实时性：搜索结果为快照数据，和网页端存在几秒～几分钟延迟；
不要依赖搜索接口做精准库存，库存需要走详情接口；
签名格式严格，时间戳、参数排序错误会直接报签名失败。
八、适用业务场景总结
ERP 系统货源检索；
跨境电商批量选品、货源调研；
竞品供应商商品监控；
供应链价格行情采集分析。
