淘宝/天猫按图搜索商品API：taobao.item_search_img返回值实战指南

淘宝/天猫的按图搜索商品API（taobao.item_search_img）为开发者提供了一个强大的工具，允许用户通过上传图片来搜索相似的商品。以下是对taobao.item_search_img API返回值的实战指南，将清晰、分点地介绍相关信息。

一、API返回值概述

taobao.item_search_img API的返回值主要包括以下几个部分：

1. 状态码（Status Code）：
   • 描述：表示API调用的成功与否。
   • 示例：200 表示成功，其他值表示不同的错误情况。
2. 错误信息（Error Message）：
   • 描述：如果调用失败，API将返回具体的错误信息，帮助开发者理解失败的原因。
3. 搜索结果（Search Results）：
   • 描述：一个包含搜索到的商品的数组或列表。
   • 内容包含：
     • 商品ID（Item ID）：每个搜索到的商品的唯一标识。
     • 商品标题（Title）：商品的名称或标题。
     • 商品价格（Price）：商品的售价，通常以元为单位。
     • 商品图片（Images）：与搜索结果中的商品相关的图片链接数组。
     • 商品链接（Permalink）：指向商品详情页面的链接。
     • 店铺信息（Shop Info）：包含提供该商品的店铺的名称、ID、评分等信息。
     • 销量（Sales）：该商品的累计销量。
     • 相似度（Similarity Score）：指示搜索到的商品与上传的图片之间的相似度评分。
     • 其他属性（Other Attributes）：可能包括商品的评分、评论数量、物流信息、优惠活动等。

 

taobao.item_search_img

公共参数

请求地址: 

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=&page=1

参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址）
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
page:页数

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮	宝贝标题
cid	Int	0	50015374
list_type	String	0	外观相似宝贝	列表类型
pic_url	String	0	//g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg	宝贝图片
promotion_price	String	0	38.71	优惠价
price	Float	0	39.50	价格
sales	Int	0	7	销量
num_iid	Bigint	0	575727312808	宝贝ID
sample_id	Bigint	0	1627115368	商品风格标识ID
seller_nick	String	0	专属味道之dzw	掌柜昵称
is_tmall	Bool	0	false
post_fee	String	0	0.00	物流费用
area	String	0	广东 东莞	店铺所在地
detail_url	String	0	//item.taobao.com/item.htm?id=575727312808&ns=1#detail	宝贝链接

二、实战指南

1. 调用API前的准备

• 完成淘宝开放平台的入驻和资质认证，获取应用的AppKey和SecretKey。
• 准备好要搜索的图片，并确保图片与想要搜索的商品相关。

2. 发起API请求

• 使用AppKey和SecretKey，通过HTTP请求向淘宝的API服务器发起请求。
• 设置请求参数，包括图片URL或图片数据，以及其他必要的请求参数，如页码、每页数量等。

3. 处理API响应

• 解析API返回的JSON格式数据。
• 提取所需的商品信息，如商品ID、标题、价格等。
• 根据需要对提取的信息进行进一步处理，如排序、筛选等。

4. 展示或使用商品数据

• 将解析出的商品数据展示在前端页面或用于其他业务逻辑。
• 可以根据相似度评分或其他属性对商品进行排序或推荐。