数字化图片化的时代,通过商品图片搜索需要的商品已经是现代人购物的日常。那么作为商家,如何使用这一功能,使自己的商品能通过图片搜索出来呢? 这里就需要两个API接口。 一个## upload_img-上传图片到淘宝的接口。一个是## item_search_img-按图搜索淘宝商品(拍立淘)。我们先上传后进行搜索,图片用post上传或者直传file 图片尺寸建议50*50。下面分享实现图片搜索的经验,申请key
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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=
参数说明:imgid:图片地址(支持淘宝或天猫图片地址,外部地址先调用上传图片(upload_img)接口,返回图片地址)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数
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 | 宝贝链接 |
同时我们还要upload_img-上传图片到淘宝
公共参数
请求地址:同上申请key地址
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:imgcode=https://img14.360buyimg.com/n0/jfs/t1/52280/38/7464/140698/5d511f6bE08290bd7/f0bb32ddb47451e8.jpg
参数说明:imgcode:base64加密后的图片内容(post方式),或者是直接上传(file方式)
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
status | Int | 0 | 1 | 状态码 |
name | String | 0 | TB14_f0bsrrK1Rjy1zeXXXalFXa | 图片名称 |
url | String | 0 | //g-search3.alicdn.com/img/bao/uploaded/i4/TB14_f0bsrrK1Rjy1zeXXXalFXa | 图片URL |
error | String | 0 | false | 错误信息 |
extraInfo | String | 0 | width:430height:430size=26429 | 图片额外信息 |
值得注意的是图片用post上传或者直传file 图片尺寸建议50*50先上传后进行搜索