電商平臺(tái)淘寶/1688商品（拍立淘）圖搜API

管理

編輯

刪除

各大電商API接口——> Brad19970108118 2025-09-17 09:30:52

暫不處理

淘寶 / 1688 的拍立淘功能（按圖搜索商品）可通過官方 API 或第三方服務(wù)實(shí)現(xiàn)，以下從核心接口、技術(shù)實(shí)現(xiàn)、注意事項(xiàng)三個(gè)維度展開說明：

一、官方 API 接入方案

1. 1688 商品圖片搜索 API（item_search_img）

1688 開放平臺(tái)提供了直接的圖片搜索接口，支持 B2B 場(chǎng)景下的同款 / 相似商品檢索，核心參數(shù)如下：

# Python調(diào)用示例（需安裝requests庫）
import requests

url = "https://api-gw.onebound.cn/1688/item_search_img"
params = {
    "key": "your_api_key",
    "imgid": "http://example.com/product.jpg",  # 圖片URL或通過upload_img接口上傳后的地址
    "page": 1,
    "sort": "sales_desc"  # 按銷量排序
}

response = requests.get(url, params=params)
data = response.json()
for item in data["items"]:
    print(f"商品標(biāo)題: {item['title']}, 價(jià)格: {item['price']}, 相似度: {item['match_rate']}")

關(guān)鍵特性：

多維度篩選：支持按類目（category_id）、價(jià)格區(qū)間（min_price/max_price）、起訂量（min_order）過濾結(jié)果。
供應(yīng)商信息：返回供應(yīng)商名稱、信用等級(jí)、所在地等，適合供應(yīng)鏈分析。
調(diào)用限制：免費(fèi)版每日≤500 次，企業(yè)版可提升額度，需通過 1688 開放平臺(tái)申請(qǐng)權(quán)限并完成企業(yè)認(rèn)證。

2. 淘寶拍立淘 API（taobao.tbk.dg.pailitao.widget.convert）

淘寶開放平臺(tái)提供的接口主要用于生成拍立淘推廣鏈接，需結(jié)合淘寶客（淘寶聯(lián)盟）功能使用：

# 生成拍立淘搜索鏈接
from top.api import TbkDgPailitaoWidgetConvertRequest

req = TbkDgPailitaoWidgetConvertRequest()
req.adzone_id = "123"  # 淘寶客推廣位ID
req.type = "0"  # 0=生成URL，1=生成deeplink
req.url = "https://example.com/product.jpg"  # 圖片URL

response = client.execute(req)
search_url = response["tbk_dg_pailitao_widget_convert_response"]["url"]

適用場(chǎng)景：

內(nèi)容導(dǎo)購：在電商 App 或網(wǎng)頁中嵌入拍立淘搜索入口，用戶點(diǎn)擊后跳轉(zhuǎn)到淘寶商品列表。
數(shù)據(jù)解析：需結(jié)合淘寶商品詳情 API（taobao.item.get）獲取價(jià)格、銷量等結(jié)構(gòu)化數(shù)據(jù)。

二、第三方服務(wù)方案

1.（商品圖片搜索）

第三方服務(wù)即用的商品圖片搜索服務(wù)，支持淘寶 / 天貓 / 1688 全平臺(tái)商品庫，優(yōu)勢(shì)如下：

高精度匹配：基于電商增強(qiáng)版 CLIP 模型，支持多角度、局部特征識(shí)別，適配服裝、工業(yè)品等場(chǎng)景。
多模態(tài)搜索：可同時(shí)輸入圖片和文本關(guān)鍵詞（如 “白色連衣裙”），提升搜索精準(zhǔn)度。
集成便捷：通過 OSS 上傳圖片，API 返回商品標(biāo)題、價(jià)格、詳情頁鏈接等，支持 JSON/XML 格式：python

# Python SDK調(diào)用示例
from aliyunsdkcore.client import AcsClient
from aliyunsdkimagesearch.request.v20200320 import SearchRequest

client = AcsClient(access_key_id, access_key_secret, "cn-hangzhou")
request = SearchRequest()
request.set_ImageURL("https://example.com/product.jpg")
request.set_MaxHits(20)  # 返回最多20個(gè)結(jié)果

response = client.do_action_with_exception(request)
for hit in response["Hits"]["Hit"]:
    print(f"商品標(biāo)題: {hit['Title']}, 價(jià)格: {hit['Price']},")

2. 開放平臺(tái)（圖像識(shí)別 + 1688 接口結(jié)合）

通過圖像識(shí)別提取圖片關(guān)鍵詞，再調(diào)用 1688 搜索 API 實(shí)現(xiàn)以圖搜貨：

from aip import AipImageClassify

APP_ID = "your_app_id"
API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"

client = AipImageClassify(APP_ID, API_KEY, SECRET_KEY)
with open("product.jpg", "rb") as f:
    image = f.read()

result = client.advancedGeneral(image)
keywords = [item["keyword"] for item in result["result"]]

# 調(diào)用1688搜索API
url = "https://api-gw.onebound.cn/1688/item_search"
params = {
    "key": "your_api_key",
    "q": " ".join(keywords),  # 組合關(guān)鍵詞搜索
    "page": 1
}
response = requests.get(url, params=params)