淘宝拍立淘 API 全解析

淘宝拍立淘 API 是淘宝开放平台提供的图像识别搜索服务，允许开发者通过上传图片快速检索淘宝 / 天猫类似商品，返回商品标题、价格、销量、链接等信息。

一、核心接口与功能

接口名称：taobao.item_search_img

基于深度学习图像识别技术 (ResNet/MobileNet) 提取图片特征，在淘宝商品库中匹配类似商品

支持商品筛选 (类目、价格、销量) 和分页查询

返回结果包含商品 ID、标题、价格、销量、图片链接、类似度评分等完整信息

技术流程：

plaintext

图像预处理 → 特征提取(高维向量) → 类似度匹配(ANN算法) → 结果排序(综合维度)

AI写代码

二、接入步骤

1. 注册与认证

在淘宝开放平台 (https://open.taobao.com) 注册账号

完成企业 / 个人实名认证 (企业需营业执照)

创建应用，获取app_key和app_secret

2. 权限申请

在 “权限管理” 中申请taobao.item_search_img接口权限

填写使用场景说明 (如 “比价系统”、”智能推荐”)

审核周期一般为 1-3 个工作日

三、调用方式

1. 请求基本信息

URL：https://eco.taobao.com/router/rest

请求方式：POST

返回格式：JSON

2. 核心请求参数

参数名 是否必填 说明

method 是 固定为 “taobao.item_search_img”

app_key 是 应用唯一标识

timestamp 是 格式：YYYY-MM-DD HH:MM:SS

format 是 固定为 “json”

v 是 固定为 “2.0”

sign_method 是 固定为 “md5”

sign 是 签名 (需按 ASCII 升序排序参数后计算)

imgid/image 是 图片 URL 或 Base64 编码的图片数据

cat (可选) 否 商品类目 ID (如女装：50010788)

page (可选) 否 页码 (默认 1, 返回 20 条 / 页)

3. 签名生成 (关键步骤)

python

运行

# Python示例

import hashlib

def generate_sign(params, app_secret):

# 1. 按ASCII升序排序参数

sorted_params = sorted(params.items())

# 2. 拼接参数

param_str = ''.join([f”{k}{v}” for k, v in sorted_params])

# 3. 在字符串前后添加app_secret

sign_str = app_secret + param_str + app_secret

# 4. 计算MD5并转为大写

return hashlib.md5(sign_str.encode()).hexdigest().upper()

AI写代码

四、代码示例 (Python)

python

运行

import requests

import hashlib

import time

def search_by_image(app_key, app_secret, img_url):

# 构建基础参数

url = “https://eco.taobao.com/router/rest”

params = {

“method”: “taobao.item_search_img”,

“app_key”: app_key,

“timestamp”: time.strftime(“%Y-%m-%d %H:%M:%S”),

“format”: “json”,

“v”: “2.0”,

“sign_method”: “md5”,

“imgid”: img_url # 或使用”image”参数传入Base64编码

}

# 生成签名

sorted_params = sorted(params.items())

sign_str = app_secret + ''.join([f”{k}{v}” for k, v in sorted_params]) + app_secret

params[“sign”] = hashlib.md5(sign_str.encode()).hexdigest().upper()

# 发送请求

response = requests.post(url, data=params)

# 解析结果

if response.status_code == 200:

return response.json()

else:

print(f”请求失败: {response.status_code}”)

return None

# 调用示例

app_key = “YOUR_APP_KEY”

app_secret = “YOUR_APP_SECRET”

img_url = “https://example.com/item.jpg”

result = search_by_image(app_key, app_secret, img_url)

for item in result.get(“items”, {}).get(“item”, []):

print(f”标题: {item['title']}, 价格: {item['price']}, 链接: {item['detail_url']}”)

AI写代码

五、返回结果解析

json

{

“items”: {

“item”: [

{

“title”: “亲子装短袖T恤”,

“price”: “39.50”,

“pic_url”: “https://g-search3.alicdn.com/…/item.jpg”,

“detail_url”: “https://item.taobao.com/item.htm?id=575727312808”,

“sales”: 7,

“match_rate”: 0.95, # 类似度评分(0-1)

“is_tmall”: false

}

]

}

}

AI写代码

六、限制与注意事项

1. 调用频率

免费版：QPS≤5，单日调用量有限

商业用途：需购买 API 套餐 (如 10 万次 / 月起)

2. 图片要求

格式：JPG/PNG，大小≤2MB

主体占比≥60%，分辨率提议≥800×800

3. 错误处理

常见错误码：

isp.no-permission：权限不足

isp.limit-exceeded：频率超限 (需添加指数退避重试)

签名错误：检查参数排序和时间戳 (±5 分钟有效)

七、应用场景

电商比价系统：实现 “线下看样，线上比价”

竞品分析：监控竞争对手热销款式

智能推荐：结合用户浏览历史提供个性化商品推荐

内容平台变现：将用户分享的图片自动关联商品链接

跨境电商：打破语言障碍，通过图片搜索全球商品

八、最佳实践

图片预处理：调整尺寸、裁剪主体、色彩标准化，提升识别准确率

结果优化：结合用户行为数据 (浏览 / 购买记录) 进行个性化排序

监控与调试：使用淘宝开放平台沙箱环境测试，定期检查接口更新

总结

淘宝拍立淘 API 通过图像识别技术实现 “以图搜商品”，是电商开发的强劲工具。核心优势在于打破语言壁垒(无需描述商品名称) 和提升搜索效率(视觉信息更直观)。

接入要点：

注册淘宝开放平台账号，完成认证

创建应用获取 app_key 和 app_secret

申请 taobao.item_search_img 接口权限

遵循签名规则，注意图片要求和调用频率限制

通过合理使用拍立淘 API，开发者可在电商、内容平台、比价工具等领域实现创新功能，为用户提供更智能便捷的购物体验。