?

在電商系統開發或貨源查找工具中，按圖搜索商品是一項非常實用的功能。1688平臺作為國內領先的B2B電商平臺，提供了官方的按圖搜索商品API接口。本文將詳細講解如何調用該接口。

一、 接口概述

該API允許開發者通過上傳商品圖片，檢索1688平臺上與之相似的商品列表。其核心功能是圖像識別與商品匹配。

二、 準備工作

獲取API權限

訪問1688開放平臺注冊開發者賬號。

創建應用，獲取 App Key 和 App Secret。

在應用權限中申請 按圖搜索商品 接口權限。

圖片要求

圖片格式支持：JPG, JPEG, PNG。

圖片大小：建議小于1MB。

圖片尺寸：建議最小邊 ≥ 256像素，清晰無過多干擾元素。

三、 API調用詳解

接口地址

https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.image.search

請求方法 POST

請求參數 關鍵參數如下：

請求示例 (Python)

import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

# 替換為你的實際信息
app_key = 'your_app_key'
app_secret = 'your_app_secret'
access_token = 'your_access_token'  # 需要通過OAuth2流程獲取
image_path = '/path/to/your/product.jpg'

# 構建請求URL
url = 'https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.image.search'

# 構建Multipart/form-data請求體
multipart_data = MultipartEncoder(
    fields={
        'access_token': access_token,
        'image': ('image.jpg', open(image_path, 'rb'), 'image/jpeg'),  # 注意字段名和文件名
        'page': '1',
        'pageSize': '20',
        'similarDegree': '0.7'
    }
)

# 設置請求頭
headers = {
    'Content-Type': multipart_data.content_type
}

# 發送請求
response = requests.post(url, data=multipart_data, headers=headers)

# 處理響應
if response.status_code == 200:
    result = response.json()
    # 解析返回的商品列表數據
    print(result)
else:
    print(f"請求失敗，狀態碼: {response.status_code}")

四、 響應解析

成功調用后，接口返回JSON格式數據。主要結構如下：

{
  "result": {
    "success": true,
    "productList": [
      {
        "productId": "商品ID",
        "title": "商品標題",
        "imageUrl": "商品主圖URL",
        "similarity": 0.85, // 與查詢圖片的相似度
        "price": "價格",
        "minOrderQuantity": "最小起訂量",
        "sellerId": "賣家ID",
        "sellerName": "賣家名稱",
        "detailPageUrl": "商品詳情頁鏈接"
      },
      // ... 更多商品
    ],
    "totalResults": 100, // 匹配到的商品總數
    "page": 1,
    "pageSize": 20
  },
  "errorCode": "0", // 0表示成功
  "errorMessage": "success"
}

五、 注意事項

訪問頻率限制： 注意開放平臺的調用頻次限制，避免觸發流控。

圖片質量： 圖片清晰度和主體突出程度直接影響搜索結果質量。

錯誤處理： 需處理常見錯誤碼，如 400（參數錯誤）、401（認證失敗）、500（服務端錯誤）等。

分頁處理： 合理使用 page 和 pageSize 參數獲取更多結果。

授權管理： access_token 有過期時間，需實現令牌的刷新機制。

六、 應用場景

電商比價工具

供應鏈貨源查找

商品侵權檢測

移動端拍照找貨應用

通過合理調用此API，開發者可以高效地整合1688的海量商品資源，為用戶提供便捷的以圖搜貨服務。

提示： 具體參數名稱、值范圍、錯誤碼等請務必以1688開放平臺官方文檔最新說明為準。在開發前，建議先用平臺提供的測試賬號和工具進行調試。

?
審核編輯 黃宇