一、 item_search_img-按图搜索淘宝商品（拍立淘）图片搜索API调用值说明：
点击注册获取key和secret测试账号
二、建议使用场景
1、图片上传获取淘宝商品详情接口
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、ERP系统商品选品
三、公共参数说明：
名称 类型 必须 描述
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版本
四、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
五、响应参数
名称 类型 是否隐私 示例值 描述
title String 亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮 宝贝标题
cid Int 50015374
list_type String 外观相似宝贝 列表类型
pic_url String //g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg 宝贝图片
promotion_price String 38.71 优惠价
price Float 39.50 价格
sales Int 7 销量
num_iid Bigint 575727312808 宝贝ID
sample_id Bigint 1627115368 商品风格标识ID
seller_nick String 专属味道之dzw 掌柜昵称
is_tmall Bool false
post_fee String 0.00 物流费用
area String 广东 东莞 店铺所在地
detail_url String //item.taobao.com/item.htm?id=575727312808&ns=1#detail 宝贝链接
六、请求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python)
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://api.onebound.cn/taobao/demo/sdk2020/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
API 工具
API SDK调用示例 APISDK下载 API测试工具
如何开通API测试，点击立即开通