1688 商品列表 API 全参数指南：从基础搜索到高级筛选

一、引言 1688 商品列表 API 是阿里巴巴 B2B 平台开放的核心数据接口之一，为开发者提供商品搜索与筛选能力。通过该接口，开发者可以批量获取符合特定条件的商品数据，广泛应用于‌商品选品‌、‌价格监控‌、‌供应链管理‌等场景。相比直接爬取网页数据，官方 API 具有‌数据规范‌、‌稳定性高‌、‌更新及时‌等优势，日均调用量可达百万级。

二、接口概述

1. 核心功能

‌关键词搜索‌：通过 q 参数实现精准商品匹配‌高级筛选‌：支持类目 ID(category_id)、价格区间(price_range)、发货地(province)等 20+维度过滤‌排序控制‌：按销量(sale_desc)、价格(price_asc)、上新(time_desc)等排序‌分页机制‌：通过 page_no+page_size 实现大数据量分批获取（单页最大 50 条）

2. 关键请求参数

参数必填说明示例值 q 否搜索关键词"蓝牙耳机"category_id 否类目 ID"509"price_range 否价格区间"10,100"page_no 是页码（从 1 开始）1page_size 是每页数量(1-50)20sort 否排序方式"sale_desc"

三、Python 代码示例

# coding:utf-8"""Compatible for python2.x and python3.xrequirement: pip install requests"""from __future__ import print_functionimport requests# 请求示例 url 默认请求参数已经做URL编码API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014url = "1688/item_search/?key=<您自己的apiKey>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter="headers = {    "Accept-Encoding": "gzip",    "Connection": "close"}if __name__ == "__main__":    r = requests.get(url, headers=headers)    json_obj = r.json()    print(json_obj)

代码说明：

‌错误处理‌：捕获 error_code 字段判断业务异常

‌性能优化‌：

设置 timeout 防止长时间阻塞使用 page_size 最大化单次获取数量

‌扩展建议‌：

添加 retry 机制应对限流(429 状态码)使用 ThreadPool 实现多页并发采集