阿里巴巴拍立淘API是一项基于图像识别技术的商品搜索服务,允许用户通过上传商品图片,系统自动识别图片中的商品信息,并返回与之相关的搜索结果。其返回值的商品信息结构通常包含多个关键部分,以下是对其商品信息结构的深度剖析:
一、主要返回值内容
- 请求标识符(request_id):
- 这是一个唯一标识符,用于追踪和调试请求。
- 状态码(code):
- 表示API调用是否成功的状态码。例如,200通常表示成功,而其他值可能表示不同的错误情况。
- 消息描述(msg):
- 与状态码对应的消息描述,用于解释操作的成功与否或错误详细信息。
- 搜索结果(items或item_list):
- 包含搜索到的商品列表,每个商品都是一个详细的数据对象。
二、商品信息字段
在搜索结果中,每个商品对象通常包含以下关键信息字段:
- 商品唯一标识符(如num_iid或productId):
- 电商平台上每个商品的唯一编号,用于唯一标识商品。
- 商品标题(title):
- 商品的名称或标题,是用户了解商品的首要信息。
- 商品图片URL(pic_url或imageUrl):
- 商品主图的URL,可用于展示商品图片,通常包含多张图片以供用户选择查看。
- 商品详情页URL(detail_url):
- 指向商品详情页面的链接,用户点击后可以跳转到电商平台的商品详情页,查看更多商品信息。
- 商品价格(price):
- 商品的售价,可能包含原价和促销价等信息,用户可以根据价格进行购买决策。
- 销量(sales或volume):
- 商品的累计销量,可能表示该商品的受欢迎程度,有助于用户评估商品的市场接受度。
- 卖家信息(seller_nick、seller_id):
- 包含提供该商品的店铺的名称、ID等信息,用户可以通过这些信息了解卖家的信誉和口碑。
- 其他属性:
- 可能包括商品的分类信息、属性(如颜色、尺寸、材质等)、评分、评论数量、物流信息、优惠活动等。这些属性进一步丰富了搜索结果,使用户能够更全面地了解商品信息。
1688.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
参数说明:imgid:图片地址(使用淘宝upload_img接口上传图片,返回图片地址)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | items[] | 0 | 按图搜索1688商品 |
三、额外信息
- 相似度得分:
- 除了商品信息外,API还可能返回一个相似度得分。这个得分通常是一个介于0到1之间的浮点数,得分越高表示相似度越高。这有助于用户判断搜索结果与上传图片的匹配程度,从而更准确地找到所需商品。
- 相关推荐:
- 拍立淘API还可能根据上传的图片推荐相关的商品。这些推荐商品可能与上传图片中的商品相似,或者属于同一类目、同一品牌等,帮助用户发现更多感兴趣的商品。