?

一、接口概述

1688開(kāi)放平臺(tái)提供alibaba.product.searchAPI接口，支持通過(guò)關(guān)鍵詞獲取商品列表。需注意：

需企業(yè)認(rèn)證賬號(hào)申請(qǐng)appKey和appSecret

數(shù)據(jù)返回格式為JSON

支持分頁(yè)參數(shù)控制數(shù)據(jù)量

二、核心請(qǐng)求參數(shù)

{
  "keywords": "手機(jī)支架",  // 搜索關(guān)鍵詞
  "pageNo": 1,            // 頁(yè)碼
  "pageSize": 20,         // 每頁(yè)數(shù)量
  "sortType": "total",    // 排序方式
  "priceStart": 10.0,     // 價(jià)格區(qū)間
  "priceEnd": 100.0
}

三、技術(shù)實(shí)現(xiàn)步驟

身份認(rèn)證

import hashlib
import time

def generate_sign(params, app_secret):
    param_str = '&'.join([f"{k}{v}" for k,v in sorted(params.items())])
    return hashlib.md5((app_secret + param_str + app_secret).encode()).hexdigest().upper()

API請(qǐng)求示例

import requests

def search_1688_product(keyword):
    base_url = "https://gw.open.1688.com/openapi/param2/2/portals.open/api.listOfferDetail/"
    params = {
        "keywords": keyword,
        "pageNo": 1,
        "pageSize": 50,
        "appKey": "YOUR_APP_KEY",
        "timestamp": int(time.time() * 1000)
    }
    params["sign"] = generate_sign(params, "YOUR_APP_SECRET")
    
    response = requests.get(base_url, params=params)
    return response.json()

四、響應(yīng)數(shù)據(jù)結(jié)構(gòu)解析

{
  "result": {
    "totalResults": 1200,
    "offerList": [
      {
        "productId": 123456789,
        "subject": "鋁合金手機(jī)支架",
        "price": 15.80,
        "minOrder": 100,
        "imageUrl": "https://img.alicdn.com/xxx.jpg",
        "companyName": "某某科技"
      }
    ]
  }
}

五、技術(shù)注意事項(xiàng)

請(qǐng)求限制

默認(rèn)QPS≤2（每秒請(qǐng)求數(shù)）

單日調(diào)用上限需參照合同約定

錯(cuò)誤處理

if response.status_code != 200:
    raise Exception(f"API請(qǐng)求失敗: {response.status_code}")

if 'error' in data:
    error_code = data['error']['code']
    # 常見(jiàn)錯(cuò)誤碼處理
    if error_code == 15: 
        print("請(qǐng)求頻率超限")

六、最佳實(shí)踐建議

使用pageSize+pageNo實(shí)現(xiàn)分頁(yè)采集

通過(guò)priceStart/priceEnd過(guò)濾無(wú)效數(shù)據(jù)

添加延時(shí)避免觸發(fā)風(fēng)控：

import random
time.sleep(random.uniform(0.5, 1.2))

法律聲明：使用API需遵守《1688開(kāi)放平臺(tái)開(kāi)發(fā)者協(xié)議》，禁止爬取非授權(quán)數(shù)據(jù)。本文示例僅作技術(shù)交流，實(shí)際調(diào)用需申請(qǐng)官方授權(quán)。

通過(guò)合理使用API接口，可高效獲取商品基礎(chǔ)信息、價(jià)格趨勢(shì)、供應(yīng)商數(shù)據(jù)等核心商業(yè)情報(bào)，為電商分析系統(tǒng)提供數(shù)據(jù)支持。

?審核編輯 黃宇