?

一、接口概述

1688開放平臺提供alibaba.product.searchAPI接口，支持通過關鍵詞獲取商品列表。需注意：

需企業(yè)認證賬號申請appKey和appSecret

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

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

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

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

三、技術實現(xià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請求示例

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()

四、響應數(shù)據(jù)結構解析

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

五、技術注意事項

請求限制

默認QPS≤2（每秒請求數(shù)）

單日調用上限需參照合同約定

錯誤處理

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

if 'error' in data:
    error_code = data['error']['code']
    # 常見錯誤碼處理
    if error_code == 15: 
        print("請求頻率超限")

六、最佳實踐建議

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

通過priceStart/priceEnd過濾無效數(shù)據(jù)

添加延時避免觸發(fā)風控：

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

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

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

?審核編輯 黃宇