淘宝开放平台拍立淘接口返回参数及调用操作指南

一、接口核心功能

拍立淘基于图像识别技术，通过上传商品图片匹配淘宝商品库，返回相似商品信息。适用于电商比价、智能推荐、竞品分析等场景。

二、返回参数详解

商品基础信息：
- title：商品标题（如"2025夏季新款连衣裙"）
- price：商品价格（如"199.00"）
- pic_url：商品主图URL
- detail_url：商品详情页链接
- sales：商品销量（如2560件）
匹配度指标：
- match_rate：相似度评分（0-1，值越高匹配度越高）
- similarity_score：相似度得分（部分接口使用）
扩展信息：
- num_iid：商品唯一ID
- promotion_price：促销价（如"6.50"）
- seller_nick：卖家昵称
- area：卖家所在地
- category_id：商品类目ID

响应结构：

json 复制代码

json
{
  "image_search_response": {
    "item_list": {
      "item": [
        {
          "title": "2025夏季新款连衣裙",
          "price": "199.00",
          "pic_url": "https://img.alicdn.com/xxx.jpg",
          "detail_url": "https://item.taobao.com/item.htm?id=123456789",
          "match_rate": 0.95,
          "sales": 2560
        }
      ]
    },
    "total_results": 10
  }
}

三、调用操作指南

1. 准备工作

注册与认证：
- 登录淘宝开放平台，完成个人/企业实名认证（需身份证/营业执照）。
- 通过基础考试，提升开发者等级至L1级。
创建应用：
- 在"控制台-应用管理"中创建应用（选择Web/移动应用类型），填写应用名称、回调URL，获取App Key和App Secret。
权限申请：
- 在"权限管理"中申请taobao.image.search或taobao.item.search.img接口权限，需填写使用场景（如"商品比价""智能推荐"），通过人工审核后生效。

2. 图片上传与处理

本地图片上传：

调用taobao.picture.upload接口，将图片Base64编码后上传，获取图片URL或ID。

示例代码（Python）：

scss 复制代码

python
import requests
import base64
 
def upload_image(app_key, app_secret, image_path):
    url = "https://eco.taobao.com/router/rest"
    with open(image_path, "rb") as f:
        image_data = base64.b64encode(f.read()).decode("utf-8")
    params = {
        "method": "taobao.picture.upload",
        "app_key": app_key,
        "timestamp": "2025-09-29 12:00:00",
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "image": image_data
    }
    # 生成签名（需按淘宝规则拼接参数并MD5加密）
    params["sign"] = generate_sign(params, app_secret)
    response = requests.post(url, data=params)
    return response.json()["picture_upload_response"]["picture"]["url"]

直接使用URL：
- 若图片已存储在外部服务器（如淘宝商品图），可直接传入图片URL。

3. 发起搜索请求

请求地址 ：https://eco.taobao.com/router/rest（HTTP POST）
关键参数：
- method: 固定为taobao.item.search.img
- image: 图片URL或Base64数据
- app_key/app_secret: 应用标识与密钥
- timestamp: 请求时间戳（格式：YYYY-MM-DD HH:MM:SS）
- sign: 签名（按MD5规则生成，需拼接参数并加密）

签名生成示例（Python） ：

python 复制代码

python
import hashlib
import time
 
def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
    sign_str = app_secret + param_str + app_secret
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

完整请求示例：

csharp 复制代码

python
import requests
 
url = "https://eco.taobao.com/router/rest"
params = {
    "method": "taobao.item.search.img",
    "app_key": "YOUR_APP_KEY",
    "timestamp": "2025-09-29 12:00:00",
    "format": "json",
    "v": "2.0",
    "image": "https://example.com/item.jpg",
    "sign_method": "md5"
}
params["sign"] = generate_sign(params, "YOUR_APP_SECRET")
response = requests.post(url, data=params)
result = response.json()

4. 响应解析与处理

解析JSON响应，提取商品信息（标题、价格、销量、链接等），可结合分页参数page获取多页数据。
数据存储：可保存至数据库（如MySQL）或导出为CSV/Excel，用于后续分析。

四、注意事项

图片质量要求：主体商品占比需超过60%，避免模糊、水印或复杂背景；支持JPG/PNG格式，大小≤2MB。
频率限制：免费版接口QPS≤5，超出会触发限流；大规模商用需购买API套餐（如10万次/月起）。
错误处理：添加重试机制、日志记录，处理签名错误、图片格式异常等异常情况。
合规性：遵守淘宝开放平台规则，避免频繁调用导致限流；处理用户图片时需符合数据安全法规。

五、典型应用场景

电商比价：通过图片搜索竞品价格，优化自身定价策略。
智能推荐：结合用户历史图片，推荐相似商品。
供应链管理：快速匹配供应商商品，提升选品效率。
竞品分析：对比平台商品图片与品牌官方图片，识别潜在假货或侵权商品。

建议定期关注淘宝开放API文档更新，确保接口调用符合最新规范。