1688商品列表API接口指南

一、引言

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

二、接口概述

1. ‌核心功能‌ 批量获取商品数据，支持分页查询（每页最多40条）‌。 多维度筛选：关键词搜索、价格区间限定、类目ID过滤等‌。 实时数据更新：价格、库存等信息可实现分钟级同步‌。
2. ‌请求参数‌ 必填参数： q：搜索关键词（如"女装"）‌。 page：页码（从1开始）‌。 pageSize：每页数量（建议≤40）‌。 可选参数： priceStart/priceEnd：价格区间过滤‌。 categoryId：类目ID。 sort：排序方式（如price_asc按价格升序）‌。

三、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加密，参数需按字母序排序‌。