一、前言

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

該接口廣泛應(yīng)用于：

電商工具開發(fā)（如同款比價(jià)、商品溯源）；

內(nèi)容電商（圖文/視頻帶貨中匹配商品）；

商家運(yùn)營(yíng)（監(jiān)控同款商品價(jià)格、銷量）。

使用前提：

創(chuàng)建應(yīng)用并獲取APPKey、APPSecret；

申請(qǐng)「拍立淘圖片搜索」接口權(quán)限（未授權(quán)會(huì)提示權(quán)限不足）；

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

二、接口概述

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

1.基礎(chǔ)信息

項(xiàng)目說(shuō)明

請(qǐng)求方式HTTPPOST

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

權(quán)限要求需申請(qǐng)「拍立淘圖片搜索」接口權(quán)限（開放平臺(tái)應(yīng)用管理頁(yè)配置）

2.核心請(qǐng)求參數(shù)（必填+關(guān)鍵）

參數(shù)名類型說(shuō)明

app_key字符串開放平臺(tái)應(yīng)用的APPKey

timestamp字符串時(shí)間戳，格式y(tǒng)yyy-MM-ddHH:mm:ss（如2026-01-1215:00:00）

format字符串響應(yīng)格式，推薦json

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

sign字符串請(qǐng)求簽名（按淘寶規(guī)則生成，簽名錯(cuò)誤直接調(diào)用失?。?/p>

image字符串圖片Base64編碼字符串（與image_url二選一，優(yōu)先級(jí)更高）

image_url字符串公網(wǎng)可訪問(wèn)的圖片URL（若傳image則該參數(shù)無(wú)效）

3.核心響應(yīng)參數(shù)

參數(shù)名類型說(shuō)明

items數(shù)組匹配的商品列表

items[].item_id字符串商品ID

items[].title字符串商品標(biāo)題

items[].price字符串商品價(jià)格

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

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

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

審核編輯 黃宇