一、摘要

本文檔旨在介紹如何通過 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=&secret=&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 請求示例。開發者可根據實際需求調整參數配置，進一步拓展業務邏輯。

審核編輯 黃宇