1688商品列表API接口指南

一、摘要

本文档旨在介绍如何通过 1688 开放平台提供的 API 接口获取商品列表信息。通过调用该接口，开发者可以实现对 1688 平台上商品数据的查询与处理，适用于电商数据分析、供应链管理等应用场景。

二、接口概述

接口名称：1688 商品列表 API

请求地址：c0b.cc/R4rbK2 。

请求方式：GET/POST（根据官方文档）

认证方式：需要 App Key 和签名（sign）进行身份验证

主要参数：

请求参数：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=

参数说明：q:搜索关键字

cat:分类 ID

start_price:开始价格

end_price:结束价格

sort:排序[bid,_bid,_sale,_credit]

(bid:总价,sale:销量,credit 信用,加_前缀为从大到小排序)

page:页数 page_size:每页宝贝数量，默认 40

filter:额外的过滤参数，如：filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000

filtId 过滤：48 小时发货,7+天包换,赠运费险,免费赊账;

activityType 优惠类型:包邮，产地货源，伙拼，手机专享价

city 地区：地区名

quantityBegin 起订量：数字

三、Python 请求示例

为方便开发者快速接入，以下是一个使用 Python 语言发起 1688 商品列表 API 请求的完整示例代码。

# 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 "

# 请求示例 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)

四、结语

通过以上内容，我们详细介绍了 1688 商品列表 API 的功能与使用方法，并提供了完整的 Python 请求示例。开发者可根据实际需求调整参数配置，进一步拓展业务逻辑。

审核编辑 黄宇