一、摘要

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

二、接口概述

接口名稱：1688 商品列表 API

請(qǐng)求地址：c0b.cc/R4rbK2 。

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

認(rèn)證方式：需要 App Key 和簽名（sign）進(jìn)行身份驗(yàn)證

主要參數(shù)：

請(qǐng)求參數(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ù)說(shuō)明：q:搜索關(guān)鍵字

cat:分類 ID

start_price:開(kāi)始價(jià)格

end_price:結(jié)束價(jià)格

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

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

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

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

filtId 過(guò)濾：48 小時(shí)發(fā)貨,7+天包換,贈(zèng)運(yùn)費(fèi)險(xiǎn),免費(fèi)賒賬;

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

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

quantityBegin 起訂量：數(shù)字

三、Python 請(qǐng)求示例

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

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

# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(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é)語(yǔ)

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

審核編輯 黃宇