淘宝拍立淘按图搜索API接口对接流程，json返回数据参考淘宝拍立淘按图搜索API接口对接流程及JSON返回数据参考一

淘宝拍立淘按图搜索API接口对接流程及JSON返回数据参考

一、接口对接流程

注册开发者账号
访问开放平台（申请API接口），完成企业或个人开发者注册，填写真实信息并通过实名认证。
创建应用并获取API密钥
- 登录开放平台控制台，进入“我的应用”页面。
- 点击“创建应用”，填写应用名称、描述等信息，选择应用类型（如“自用型”或“他用型”）。
- 在“权限管理”中申请taobao.item_search_img（图片搜索）权限，填写使用场景说明（如“通过图片搜索商品功能”）。
- 审核通过后，在“应用信息”中获取app_key和app_secret，用于后续接口调用。

图片上传与处理

淘宝/天猫图片：直接使用商品图片URL（如https://img.alicdn.com/xxx.jpg）。

外部图片：需先调用淘宝upload_img接口上传图片，获取图片URL或ID。示例代码：

python
	import requests

	def upload_image(app_key, app_secret, image_path):

	    url = "https://api.taobao.com/router/rest"

	    params = {

	        "method": "taobao.picture.upload",

	        "app_key": app_key,

	        "timestamp": "2025-07-02 16:09:16",

	        "format": "json",

	        "v": "2.0",

	        "sign_method": "md5",

	        "image": base64.b64encode(open(image_path, "rb").read()).decode("utf-8")

	    }

	    params["sign"] = generate_sign(params, app_secret)  # 需按淘宝规则生成签名

	    response = requests.get(url, params=params)

	    return response.json().get("picture_upload_response", {}).get("picture", {}).get("url")

调用拍立淘API

请求URL：https://api.taobao.com/imgsearch/item_search_img.do（实际URL以官方文档为准）。

请求参数：

参数名	类型	必填	说明
key	string	是	应用的`app_key`
secret	string	是	应用的`app_secret`
imgid	string	是	图片URL或ID
cat	string	否	商品类目ID（如“16”为女装）
page	int	否	分页页码（默认1）

示例代码：

python
	import requests

	def search_by_image(app_key, app_secret, img_url):

	    url = "https://api.taobao.com/imgsearch/item_search_img.do"

	    params = {

	        "key": app_key,

	        "secret": app_secret,

	        "imgid": img_url,

	        "page": 1

	    }

	    response = requests.get(url, params=params)

	    return response.json()

处理响应数据
- 检查返回数据中是否包含error_response字段，若有则根据错误码处理（如40001表示参数错误）。
- 解析items字段中的商品列表，提取所需信息。

二、JSON返回数据示例

json
	{

	  "items": {

	    "item": [

	      {

	        "title": "2025夏季新款女装连衣裙修身显瘦气质裙子",

	        "pic_url": "https://img.alicdn.com/bao/uploaded/i1/123456789/O1CN01abc123.jpg",

	        "promotion_price": "129.00",

	        "price": "199.00",

	        "sales": 2560,

	        "num_iid": "123456789",

	        "seller_nick": "美丽衣橱旗舰店",

	        "is_tmall": true,

	        "area": "浙江 杭州",

	        "detail_url": "https://item.taobao.com/item.htm?id=123456789",

	        "similarity_score": 0.95

	      },

	      {

	        "title": "夏季新款女装雪纺连衣裙中长款碎花裙子",

	        "pic_url": "https://img.alicdn.com/bao/uploaded/i2/987654321/O1CN01xyz987.jpg",

	        "promotion_price": "159.00",

	        "price": "259.00",

	        "sales": 1890,

	        "num_iid": "987654321",

	        "seller_nick": "时尚女装店",

	        "is_tmall": false,

	        "area": "广东 广州",

	        "detail_url": "https://item.taobao.com/item.htm?id=987654321",

	        "similarity_score": 0.92

	      }

	    ]

	  },

	  "total_results": 2,

	  "request_id": "abc123xyz456"

	}

三、关键字段说明

字段名	类型	说明
`title`	string	商品标题
`pic_url`	string	商品主图URL
`promotion_price`	string	促销价（可能为空）
`price`	string	原价
`sales`	int	销量
`num_iid`	string	商品ID
`seller_nick`	string	卖家昵称
`is_tmall`	boolean	是否为天猫商品
`area`	string	发货地（如“浙江杭州”）
`detail_url`	string	商品详情页URL
`similarity_score`	float	相似度评分（0-1，越高越匹配）