淘宝天猫图片搜索API接口指南

一、前言

淘宝图片搜索 API（核心为「拍立淘」相关接口）是淘宝开放平台（TOP）提供的视觉检索接口，核心能力是基于上传的图片 / 图片 URL，检索淘宝 / 天猫平台的同款、相似商品。

该接口广泛应用于：

电商工具开发（如同款比价、商品溯源）；

内容电商（图文 / 视频带货中匹配商品）；

商家运营（监控同款商品价格、销量）。

使用前提：

创建应用并获取APP Key、APP Secret；

申请「拍立淘图片搜索」接口权限（未授权会提示权限不足）；

图片需满足格式（JPG/PNG）、大小（≤5MB）、分辨率（≥200x200）要求。

二、接口概述

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

1. 基础信息

项目说明

请求方式HTTP POST

正式环境地址：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取）。

权限要求需申请「拍立淘图片搜索」接口权限（开放平台应用管理页配置）

2. 核心请求参数（必填 + 关键）

参数名类型说明

app_key字符串开放平台应用的 APP Key

timestamp字符串时间戳，格式yyyy-MM-dd HH:mm:ss（如2026-01-12 15: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布尔值是否找到同款商品。