一、前言

淘寶圖片搜索API（核心為「拍立淘」相關接口）是淘寶開放平臺（TOP）提供的視覺檢索接口，核心能力是基于上傳的圖片/圖片URL，檢索淘寶/天貓平臺的同款、相似商品。

該接口廣泛應用于：

電商工具開發（如同款比價、商品溯源）；

內容電商（圖文/視頻帶貨中匹配商品）；

商家運營（監控同款商品價格、銷量）。

使用前提：

創建應用并獲取APPKey、APPSecret；

申請「拍立淘圖片搜索」接口權限（未授權會提示權限不足）；

圖片需滿足格式（JPG/PNG）、大?。ā?MB）、分辨率（≥200x200）要求。

二、接口概述

以淘寶官方「拍立淘圖片搜索接口（taobao.image.search）」為例，核心信息如下：

1.基礎信息

項目說明

請求方式HTTPPOST

正式環境地址：c0b.cc/R4rbK2(前往體驗接口測試，Taobaoapi2014添加V獲?。?/p>

權限要求需申請「拍立淘圖片搜索」接口權限（開放平臺應用管理頁配置）

2.核心請求參數（必填+關鍵）

參數名類型說明

app_key字符串開放平臺應用的APPKey

timestamp字符串時間戳，格式yyyy-MM-ddHH:mm:ss（如2026-01-1215:00:00）

format字符串響應格式，推薦json

v字符串接口版本，固定2.0

sign字符串請求簽名（按淘寶規則生成，簽名錯誤直接調用失敗）

image字符串圖片Base64編碼字符串（與image_url二選一，優先級更高）

image_url字符串公網可訪問的圖片URL（若傳image則該參數無效）

3.核心響應參數

參數名類型說明

items數組匹配的商品列表

items[].item_id字符串商品ID

items[].title字符串商品標題

items[].price字符串商品價格

items[].pic_url字符串商品主圖URL

items[].score數字相似度得分（0-100，越高越相似）

has_matching布爾值是否找到同款商品。

審核編輯 黃宇