一、摘要

本文檔旨在介紹如何通過 1688 開放平臺提供的 API 接口獲取商品列表信息。通過調(diào)用該接口，開發(fā)者可以實現(xiàn)對 1688 平臺上商品數(shù)據(jù)的查詢與處理，適用于電商數(shù)據(jù)分析、供應(yīng)鏈管理等應(yīng)用場景。

二、接口概述

接口名稱：1688 商品列表 API

請求地址：c0b.cc/R4rbK2 。

請求方式：GET/POST（根據(jù)官方文檔）

認證方式：需要 App Key 和簽名（sign）進行身份驗證

主要參數(shù)：

請求參數(shù)：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=

參數(shù)說明：q:搜索關(guān)鍵字

cat:分類 ID

start_price:開始價格

end_price:結(jié)束價格

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

(bid:總價,sale:銷量,credit 信用,加_前綴為從大到小排序)

page:頁數(shù) page_size:每頁寶貝數(shù)量，默認 40

filter:額外的過濾參數(shù)，如：filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000

filtId 過濾：48 小時發(fā)貨,7+天包換,贈運費險,免費賒賬;

activityType 優(yōu)惠類型:包郵，產(chǎn)地貨源，伙拼，手機專享價

city 地區(qū)：地區(qū)名

quantityBegin 起訂量：數(shù)字

三、Python 請求示例

為方便開發(fā)者快速接入，以下是一個使用 Python 語言發(fā)起 1688 商品列表 API 請求的完整示例代碼。

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置參數(shù) API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "

# 請求示例 url 默認請求參數(shù)已經(jīng)做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)

四、結(jié)語

通過以上內(nèi)容，我們詳細介紹了 1688 商品列表 API 的功能與使用方法，并提供了完整的 Python 請求示例。開發(fā)者可根據(jù)實際需求調(diào)整參數(shù)配置，進一步拓展業(yè)務(wù)邏輯。

審核編輯 黃宇