1688商品 API接口，開發(fā)者詳解與使用指南

管理

編輯

刪除

OneLafite 2025-07-07 16:08:11

其他

訪問平臺(tái)：前往1688開放平臺(tái)。
賬號(hào)要求：個(gè)人開發(fā)者：綁定通過個(gè)人實(shí)名認(rèn)證的支付寶賬號(hào)。企業(yè)開發(fā)者：綁定通過企業(yè)認(rèn)證的支付寶賬號(hào)。
注冊(cè)流程：使用阿里巴巴中國站賬號(hào)登錄，完成支付寶綁定及實(shí)名認(rèn)證。

步驟：登錄開放平臺(tái)控制臺(tái)，創(chuàng)建新應(yīng)用。提交產(chǎn)品MRD（市場(chǎng)需求文檔）至郵箱[email protected]審核，審核通過后正式發(fā)布應(yīng)用。
獲取憑證：應(yīng)用審核通過后，獲得App Key和App Secret，用于后續(xù)API調(diào)用認(rèn)證。

二、API接口概覽

接口名：alibaba.item.search
功能：通過關(guān)鍵詞、價(jià)格區(qū)間、銷量范圍、類目ID等條件篩選商品，返回商品標(biāo)題、價(jià)格、銷量、圖片等基本信息。
請(qǐng)求參數(shù)： q：搜索關(guān)鍵詞（如“女裝”）。 page：頁碼（默認(rèn)1）。 pageSize：每頁商品數(shù)量（最大40）。 priceStart/priceEnd：價(jià)格區(qū)間。 categoryId：類目ID（通過類目搜索接口獲取）。 sort：排序方式（如price_asc按價(jià)格升序）。

接口名：alibaba.cpsMedia.productInfo
功能：獲取商品的詳細(xì)信息，包括價(jià)格、庫存、詳情描述等。
注意：需結(jié)合alibaba.cps.queryOfferDetailActivity接口獲取營(yíng)銷活動(dòng)信息，以確定最終價(jià)格和運(yùn)費(fèi)。價(jià)格優(yōu)先級(jí)：channelPrice（一件代發(fā)包郵價(jià)）> promotionPrice（營(yíng)銷活動(dòng)價(jià)）> consignPrice（分銷基準(zhǔn)價(jià)）。

邏輯：若商品存在channelPrice，則為包郵商品，可通過channelPriceFreePostage和channelPriceExcludeAreaCodes判斷非包郵區(qū)域。若無channelPrice但有promotionPrice，以營(yíng)銷活動(dòng)接口返回的包郵信息為準(zhǔn)。若無以上兩者，則通過shippingInfo中的運(yùn)費(fèi)模板計(jì)算。
示例：按重量計(jì)價(jià)：chargeType=0，首重1000克費(fèi)用700分，續(xù)重1000克費(fèi)用250分，2公斤商品運(yùn)費(fèi)為9.5元。按件計(jì)價(jià)：chargeType=1，首件3件費(fèi)用700分，續(xù)件1件費(fèi)用250分，1件商品運(yùn)費(fèi)為7元。

算法：使用App Secret對(duì)請(qǐng)求參數(shù)進(jìn)行MD5加密。
示例代碼（Python）： python 體驗(yàn)AI代碼助手代碼解讀復(fù)制代碼python import hashlib import urllib.parse def generate_sign(params, app_secret): sorted_params = sorted(params.items(), key=lambda x: x[0]) query_string = ''.join([f"{k}{v}" for k, v in sorted_params]) sign_str = app_secret + query_string + app_secret return hashlib.md5(sign_str.encode()).hexdigest().upper()

方式：HTTP GET或POST。
示例代碼（Python）： csharp 體驗(yàn)AI代碼助手代碼解讀復(fù)制代碼python import requests import time app_key = "your_app_key" app_secret = "your_app_secret" params = { "method": "alibaba.item.search", "app_key": app_key, "timestamp": int(time.time()), "format": "json", "v": "2.0", "q": "女裝", "page": 1, "pageSize": 40 } params["sign"] = generate_sign(params, app_secret) response = requests.get("https://gw.open.1688.com/openapi/param2/1/portals.open/api/findItem", params=params) print(response.text)

關(guān)鍵字段： totalResults：總記錄數(shù)。 items：商品數(shù)組，包含title、price、sales、picUrl等。
示例響應(yīng)： json 體驗(yàn)AI代碼助手代碼解讀復(fù)制代碼json { "success": true, "result": { "totalResults": 12345, "items": [ { "title": "韓版仿兔毛圍巾", "price": "2.2", "sales": 1234, "picUrl": "https://img.1688.com/img/xxxxxx.jpg" } ] } }