淘宝API接口按图搜图，item_search_img - 按图搜索商品（拍立淘）
onebound.taobao.item_search_img
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中）注册Key和secret测试 |
| 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 | 宝贝链接 |
请求示例Curl PHP PHPsdk JAVA C# Python请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "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="Request address:
https://api-gw.onebound.cn/taobao/item_search_img/?key=t&
&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=&&lang=zh-CN&secret=
---------------------------------------
Result Object:
---------------------------------------
{
"items": {
"pagecount": 1,
"total_results": 32,
"real_total_results": 32,
"item": [
{
"title": "儿童篮球长袜子中小学生科比夏季薄款纯棉防滑底吸汗透气防臭高帮",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4//i1/1426460030/O1CN018GrzHT1C5melbEjRt_!!0-saturn_solar.jpg",
"promotion_price": "10.6",
"price": "10.6",
"sales": 1,
"num_iid": "677494146302",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "台州",
"detail_url": "//item.taobao.com/item.htm?id=677494146302",
"cid": null
},
{
"title": "精英篮球袜男士成人加厚毛巾底中筒袜耐磨透气比赛专业运动球袜子",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01Yv88bu1wvVg0H7ADe_!!875286370.jpg",
"promotion_price": "20",
"price": "20",
"sales": 0,
"num_iid": "668987399113",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=668987399113",
"cid": "50017261"
},
{
"title": "专业篮球袜男高帮中长筒球员版毛巾底美式斗牛实战精英袜运动袜子",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01W8oilm1xYRHdRtVN3_!!1731886455.jpg",
"promotion_price": "12.8",
"price": "12.8",
"sales": 374,
"num_iid": "644787395095",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=644787395095",
"cid": "50017261"
},
{
"title": "球员版精英篮球袜男女中长筒高帮专业毛巾底棉花糖闪击七运动袜子",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01c41qhU1TJNmuoCtV3_!!1575692361.jpg",
"promotion_price": "16",
"price": "16",
"sales": 21,
"num_iid": "643708468558",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=643708468558",
"cid": "50015374"
},
{
"title": "球员版实战专业篮球袜子男女美式中长筒夏季毛巾底专业精英运动袜",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01Yl2BUK1xYRJlUSjhG_!!1731886455.jpg",
"promotion_price": "15.8",
"price": "15.8",
"sales": 6,
"num_iid": "655846298025",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=655846298025",
"cid": "50017261"
},
{
"title": "库里勇士队汤普森篮球袜男高帮精英实战curry长筒运动专业毛巾袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01iInesG1pYskQxCMeA_!!552855373.jpg",
"promotion_price": "29",
"price": "29",
"sales": 1,
"num_iid": "648241921818",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "青岛",
"detail_url": "//item.taobao.com/item.htm?id=648241921818",
"cid": "50017261"
},
{
"title": "领途实战篮球袜男款防滑吸汗运动球袜毛巾底高帮中筒青年足球袜子",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01RxWV8K2J9dTULPHrr_!!171429379.jpg",
"promotion_price": "10.9",
"price": "10.9",
"sales": 1,
"num_iid": "681182669452",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=681182669452",
"cid": "50015374"
},
{
"title": "三双包邮STANCE NBA球队版精英实战篮球系列高强度运动袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN0168TPFS1mpsPlgbBkg_!!2862565004.jpg",
"promotion_price": "25.9",
"price": "25.9",
"sales": 1,
"num_iid": "590686173312",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "东莞",
"detail_url": "//item.taobao.com/item.htm?id=590686173312",
"cid": "50017261"
},
{
"title": "STANCE袜子男中筒袜NBA火箭队勇士队专业篮球精英袜 559系列",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/TB2QuyJXjgy_uJjSZSyXXbqvVXa_!!186192253.jpg",
"promotion_price": "149",
"price": "149",
"sales": 0,
"num_iid": "558920952433",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "营口",
"detail_url": "//item.taobao.com/item.htm?id=558920952433",
"cid": "50017261"
},
{
"title": "库里30号儿童袜成年毛巾底篮球袜中高筒专业精英袜球星同号篮球袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01jOQrbU1ynNszBPRNs_!!2212656286623.jpg",
"promotion_price": "19.9",
"price": "19.9",
"sales": 0,
"num_iid": "669165045112",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "长沙",
"detail_url": "//item.taobao.com/item.htm?id=669165045112",
"cid": "50017261"
},
{
"title": "【清仓】准者长筒篮球袜男CUBA毛巾袜防滑耐磨透气吸汗高帮精英袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01UxIAX71ELTRGpIO9F_!!92580335.jpg",
"promotion_price": "21",
"price": "21",
"sales": 0,
"num_iid": "668805221071",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "泉州",
"detail_url": "//item.taobao.com/item.htm?id=668805221071",
"cid": "50017261"
},
{
"title": "科比詹姆斯欧文篮球服袜子男高筒精英运动高中帮专业实战加厚长袜",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01HlZdE32EA1hFoIa73_!!2136308703.jpg",
"promotion_price": "15.9",
"price": "15.9",
"sales": 2,
"num_iid": "668940087693",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=668940087693",
"cid": "50017261"
},
{
"title": "精英篮球袜 特大码运动袜 防臭吸汗耐磨袜子 高筒球队配色男袜",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/TB2yZ3pbxvzQeBjSZPfXXbWGFXa_!!137698885.jpg",
"promotion_price": "55",
"price": "55",
"sales": 0,
"num_iid": "526114613604",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "上海",
"detail_url": "//item.taobao.com/item.htm?id=526114613604",
"cid": "50015374"
},
{
"title": "STACNE 2022新款FEEL100缓震透气女专业运动袜几何图案中筒袜子",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01WSewR61tUXVl9fYMj_!!0-item_pic.jpg",
"promotion_price": "110",
"price": "110",
"sales": 3,
"num_iid": "668191215855",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "上海",
"detail_url": "//item.taobao.com/item.htm?id=668191215855",
"cid": "50015374"
},
{
"title": "欧文精英篮球袜男高帮长筒纯棉中筒加厚毛巾底吸汗防滑实战运动袜",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01iXbKsi26m1XpFuT8k_!!3547947703.jpg",
"promotion_price": "17.9",
"price": "17.9",
"sales": 0,
"num_iid": "635063120049",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=635063120049",
"cid": "50017261"
},
{
"title": "实战篮球袜男款女款粉色防滑吸汗运动球袜毛巾底高帮中筒精英袜",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01byzVvD1rhhhuRcmyp_!!196785663.jpg",
"promotion_price": "13",
"price": "13",
"sales": 0,
"num_iid": "687257356053",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=687257356053",
"cid": "50017261"
},
{
"title": "【球星款】篮球袜男高筒精英运动男高帮专业中筒袜子长筒实战球袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01sQctNd1iHkgrGdVEx_!!2207334854388.jpg",
"promotion_price": "39",
"price": "39",
"sales": 0,
"num_iid": "674463816170",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=674463816170",
"cid": "50017261"
},
{
"title": "学生斗牛篮球袜男高帮运动训练精英实战专业长中筒毛巾底跑步袜子",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01TEjbc11gvwDMShHdj_!!2983744205.jpg",
"promotion_price": "29.9",
"price": "29.9",
"sales": 0,
"num_iid": "675433400213",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "北京",
"detail_url": "//item.taobao.com/item.htm?id=675433400213",
"cid": "50017261"
},
{
"title": "UA毛巾底NBA球员版篮球袜精英袜库里中高筒专业训练加厚吸汗缓震",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01VPXwqZ2HE65WuPTyo_!!519559118.jpg",
"promotion_price": "12.9",
"price": "12.9",
"sales": 1,
"num_iid": "676423099619",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "衢州",
"detail_url": "//item.taobao.com/item.htm?id=676423099619",
"cid": "50017261"
},
{
"title": "准者袜男低帮短袜跑步运动袜中筒专业防滑篮球袜长筒袜加厚精英袜",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01tQO8LJ1TrH9mrHKMB_!!2181532435.jpg",
"promotion_price": "8.91",
"price": "8.91",
"sales": 1979,
"num_iid": "556682941324",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "泉州",
"detail_url": "//item.taobao.com/item.htm?id=556682941324",
"cid": "50015374"
},
{
"title": "男袜子纯棉中筒袜秋冬季篮球 袜子男运动袜 精英袜高筒加厚毛巾底",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/TB2S_DndHJmpuFjSZFBXXXaZXXa_!!2573809305.jpg",
"promotion_price": "19",
"price": "19",
"sales": 1,
"num_iid": "540352421143",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=540352421143",
"cid": "201581801"
},
{
"title": "儿童羽毛球袜子毛巾底袜运动袜男童篮球袜中筒跑步短袜乒乓球女童",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01qvWYsU1Mw82go8a1p_!!2272921498.jpg",
"promotion_price": "18",
"price": "18",
"sales": 123,
"num_iid": "44219419478",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=44219419478",
"cid": "50012333"
},
{
"title": "黑人月科比詹姆斯欧文杜兰特精英袜篮球袜加厚毛巾底中高筒运动袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/TB2juZfaOAKL1JjSZFoXXagCFXa_!!245342059.jpg",
"promotion_price": "15",
"price": "15",
"sales": 0,
"num_iid": "543830837654",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "深圳",
"detail_url": "//item.taobao.com/item.htm?id=543830837654",
"cid": "50017261"
},
{
"title": "春秋中厚款透气篮球袜子中筒纯棉防臭舒适男女儿童运动红蓝黄绿",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01L7xO5f23QYFBhrLdp_!!119327250.jpg",
"promotion_price": "29.8",
"price": "29.8",
"sales": 1,
"num_iid": "623910409474",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "重庆",
"detail_url": "//item.taobao.com/item.htm?id=623910409474",
"cid": "50017261"
},
{
"title": "【球星款】篮球袜男高筒精英运动男高帮专业中筒袜子长筒实战球袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01hBvEuY2JoOf6v6OwS_!!2207641519468.jpg",
"promotion_price": "47.5",
"price": "47.5",
"sales": 3,
"num_iid": "658688647149",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=658688647149",
"cid": "50017261"
},
{
"title": "李宁护踝防崴脚男脚腕篮球脚踝护具扭伤运动固定器恢复关节保护套",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01zOIMVs1LqnsEcvFws_!!816191351.jpg",
"promotion_price": "80.1",
"price": "80.1",
"sales": 618,
"num_iid": "555430755838",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "上海",
"detail_url": "//item.taobao.com/item.htm?id=555430755838",
"cid": "201384317"
},
{
"title": "Sports House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01GEN7gN1mzxPFz3pm7_!!3894675026.jpg",
"promotion_price": "9",
"price": "9",
"sales": 0,
"num_iid": "683707856686",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "上海",
"detail_url": "//item.taobao.com/item.htm?id=683707856686",
"cid": "50015374"
},
{
"title": "现货 李宁CBA赞助全毛巾高帮包裹保护篮球精英袜AWLK179-2",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01eQyzDE1FaPutHkdkA_!!123840503.jpg",
"promotion_price": "25",
"price": "25",
"sales": 0,
"num_iid": "571190209247",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "苏州",
"detail_url": "//item.taobao.com/item.htm?id=571190209247",
"cid": "50015374"
},
{
"title": "精英篮球袜男跑步袜中筒加厚毛巾底羽毛球袜防滑耐磨专业运动袜子",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01AbgeRp1p4C8VcSjAa_!!2528385306.jpg",
"promotion_price": "7.8",
"price": "7.8",
"sales": 0,
"num_iid": "622137552490",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=622137552490",
"cid": "50015374"
},
{
"title": "斗牛实战篮球袜男高筒袜子毛巾底美式专业精英袜白色运动袜跑步袜",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01cTnFt42BR1Zpq9Jmc_!!385328334.jpg",
"promotion_price": "12.9",
"price": "12.9",
"sales": 13,
"num_iid": "677655298027",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "惠州",
"detail_url": "//item.taobao.com/item.htm?id=677655298027",
"cid": "50017261"
},
{
"title": "篮球袜子男科比詹姆斯杜兰特球员毛巾底高帮防臭专业运动长筒袜qw",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01jft1IA1JA5giNtOD1_!!3527470987.jpg",
"promotion_price": "16.6",
"price": "16.6",
"sales": 0,
"num_iid": "679576342707",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=679576342707",
"cid": "50015374"
},
{
"title": "UA毛巾底加厚中高筒库里联名7篮球运动防滑透气吸汗精英篮球袜NBA",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01eBm2hR1kLX9VSvC6O_!!3268084667.jpg",
"promotion_price": "19",
"price": "19",
"sales": 242,
"num_iid": "658150614930",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "绍兴",
"detail_url": "//item.taobao.com/item.htm?id=658150614930",
"cid": "50015374"
}
],
"data_from": "app_t"
},
"error_code": "0000",
"reason": "ok",
"secache": "805dd061d51a733c7a85711ba0a36267",
"secache_time": 1667288255,
"secache_date": "2022-11-01 15:37:35",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 1,
"api_info": "today:155 max:10100 all[288=155+82+51];expires:2030-12-31",
"execution_time": "0.05",
"server_time": "Beijing/2022-11-01 16:03:52",
"client_ip": "106.6.34.202",
"call_args": {
"imgid": "http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "0.94MB",
"request_id": "gw-4.6360d2e8408b6",
"last_id": "1326975994"
}