一、引言

1688商品列表API是阿里巴巴开放平台提供的核心接口，支持通过关键词、价格区间、类目等条件筛选商品，返回商品标题、价格、销量等基础信息，广泛应用于电商数据分析、竞品监控等场景。该接口采用RESTful设计，响应格式为JSON，平均响应时间≤500ms（企业认证用户）。

二、接口概述

核心功能

批量获取商品数据，支持分页查询（每页最多40条）。

多维度筛选：关键词搜索、价格区间限定、类目ID过滤等。

实时数据更新：价格、库存等信息可实现分钟级同步。

请求参数

必填参数：

q：搜索关键词（如"女装"）。

page：页码（从1开始）。

pageSize：每页数量（建议≤40）。

可选参数：

priceStart/priceEnd：价格区间过滤。

categoryId：类目ID。

sort：排序方式（如price_asc按价格升序）。

三、Python请求示例

python

# coding:utf-8 ""

" Compatible for python2.x and python3.x requirement: pip install requests ""

" from __future__ import print_function import requests

# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "

app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词

# 请求示例 url 默认请求参数已经做URL编码 url = "1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&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)

代码需替换实际APP_KEY，签名算法采用MD5加密，参数需按字母序排序。