item_search_img - 按图搜索淘宝商品（拍立淘）
公共参数
点击注册免费获取key，secret 点击获取
请求参数
请求参数：imgid=g-search3.alicdn.com/img/bao/upl… 参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址） 如:img.alicdn.com/imgextra/i3…
响应示例（Java）
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String 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=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
响应参数
注册免费获取测试权限：点击这里
返回实例
Result Object:
---------------------------------------
{
"items": {
"pagecount": 1,
"total_results": 33,
"real_total_results": 33,
"item": [
{
"title": "斯伯丁篮球运动袜学生跑步健身专业比赛袜子送礼物盒",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4//i2/2211530463471/O1CN01BQQqg51bVlWglX3Ic_!!2211530463471.jpg",
"promotion_price": "14",
"price": "14",
"sales": 298,
"num_iid": "663073299000",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=663073299000",
"cid": null
},
{
"title": "斗牛实战篮球袜男高筒袜子毛巾底美式专业精英袜白色运动袜跑步袜",
"pic_url": "http://g.search.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": "落脚点Sports House运动之家篮球袜男士实战精英袜透气运动袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01jFYXRY1O0zuiGE0ig_!!1649091644.jpg",
"promotion_price": "9",
"price": "9",
"sales": 3,
"num_iid": "684887563975",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "上海",
"detail_url": "//item.taobao.com/item.htm?id=684887563975",
"cid": "50015374"
},
{
"title": "UA毛巾底NBA球员版篮球袜精英袜库里中高筒专业训练加厚吸汗缓震",
"pic_url": "http://g.search3.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": "库里勇士队汤普森篮球袜男高帮精英实战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.search.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": "库里30号儿童袜成年毛巾底篮球袜中高筒专业精英袜球星同号篮球袜",
"pic_url": "http://g.search.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.search1.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.search1.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/O1CN01HlZdE32EA1hFoIa73_!!2136308703.jpg",
"promotion_price": "15.9",
"price": "15.9",
"sales": 1,
"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.search1.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": "韦德代言ST专业篮球袜加厚球员版赞助款篮球袜 精英袜无logo",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/TB2A02KopXXXXXgXFXXXXXXXXXX_!!351369262.jpg",
"promotion_price": "28.5",
"price": "28.5",
"sales": 2,
"num_iid": "543436341302",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "南通",
"detail_url": "//item.taobao.com/item.htm?id=543436341302",
"cid": "50015374"
},
{
"title": "Sports House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
"pic_url": "http://g.search3.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": "篮球袜子男科比詹姆斯杜兰特球员毛巾底高帮防臭专业运动长筒袜qw",
"pic_url": "http://g.search2.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": "精英篮球袜子男短袜夏季薄款中筒美式实战毛巾底专业跑步运动袜子",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01l5Yeex24zBkhH55PQ_!!2207298697461.jpg",
"promotion_price": "8.4",
"price": "8.4",
"sales": 14,
"num_iid": "611069068828",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=611069068828",
"cid": "50017261"
},
{
"title": "Sports House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01Pl0G3v1qv9iAghyqV_!!395705557.jpg",
"promotion_price": "139.9",
"price": "139.9",
"sales": 0,
"num_iid": "681175587531",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "新界",
"detail_url": "//item.taobao.com/item.htm?id=681175587531",
"cid": "50015374"
},
{
"title": "JG军哥篮球袜子毛巾底实战长筒专业运动训练精英袜男跑步加厚高帮",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN017lzcJJ1RdsHPxHyuK_!!1066772135.jpg",
"promotion_price": "22",
"price": "22",
"sales": 8,
"num_iid": "623750915688",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "泉州",
"detail_url": "//item.taobao.com/item.htm?id=623750915688",
"cid": "50017261"
},
{
"title": "实战篮球袜男款女款粉色防滑吸汗运动球袜毛巾底高帮中筒精英袜",
"pic_url": "http://g.search3.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/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.search2.alicdn.com/img/bao/uploaded/i4/O1CN01DaRCKX1GPiFTGmg43_!!2878470615.jpg",
"promotion_price": "18",
"price": "18",
"sales": 1,
"num_iid": "644171077024",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "宜春",
"detail_url": "//item.taobao.com/item.htm?id=644171077024",
"cid": "50017261"
},
{
"title": "斗牛篮球袜男中长筒实战球员版专业短袜高帮加厚毛巾底精英运动袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01XbEkbX21LqtBBp7kh_!!1983416969.jpg",
"promotion_price": "6.8",
"price": "6.8",
"sales": 1,
"num_iid": "655739838575",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=655739838575",
"cid": "50017261"
},
{
"title": "李宁护踝防崴脚男脚腕篮球脚踝护具扭伤运动固定器恢复关节保护套",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01zOIMVs1LqnsEcvFws_!!816191351.jpg",
"promotion_price": "80.1",
"price": "80.1",
"sales": 642,
"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": "左右力量篮球袜JG军哥联名款毛巾底实战长筒高帮精英运动袜跑步袜",
"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01F9AWMe2FcFcbtbjlo_!!2206637888900.jpg",
"promotion_price": "23.4",
"price": "23.4",
"sales": 6,
"num_iid": "624755140459",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "泉州",
"detail_url": "//item.taobao.com/item.htm?id=624755140459",
"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": "运动袜子男篮球袜专业跑步女长中筒高帮健身加厚实战毛巾底精英袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01l3dGyo2LY1oJ4ku65_!!3937219703-0-C2M.jpg",
"promotion_price": "8.9",
"price": "8.9",
"sales": 124,
"num_iid": "686319044847",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=686319044847",
"cid": "50015374"
},
{
"title": "三双包邮STANCE NBA球队版精英实战篮球系列高强度运动袜",
"pic_url": "http://g.search3.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": "马布里实战专业篮球袜子毛巾底高筒运动精英男中高帮长筒训练美式",
"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01jcfVQr1owry03ClLt_!!2212248695290.jpg",
"promotion_price": "14.22",
"price": "14.22",
"sales": 212,
"num_iid": "673847572049",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "厦门",
"detail_url": "//item.taobao.com/item.htm?id=673847572049",
"cid": "50017261"
},
{
"title": "NCAA北卡蓝篮球精英袜中长筒专业高帮毛巾底运动袜子男女球鞋配袜",
"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01QKkeS12Ap0YhL2h16_!!656628251-0-lubanu-s.jpg",
"promotion_price": "25.2",
"price": "25.2",
"sales": 14,
"num_iid": "626065929120",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=626065929120",
"cid": "50017261"
},
{
"title": "球星篮球袜男高筒运动高帮专业中长筒袜子实战训练科比詹姆斯球袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01EFzdCJ1JFaL98HRBD_!!2261100999.jpg",
"promotion_price": "13.8",
"price": "13.8",
"sales": 3,
"num_iid": "640928293526",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=640928293526",
"cid": "50017261"
},
{
"title": "篮球袜子中长筒短筒高帮跑步袜男士户外专业运动加厚毛巾底精英袜",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01tiizk31ph7k5Vutd4_!!271045391.jpg",
"promotion_price": "6.8",
"price": "6.8",
"sales": 13,
"num_iid": "600321872541",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "杭州",
"detail_url": "//item.taobao.com/item.htm?id=600321872541",
"cid": "50017261"
},
{
"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.search.alicdn.com/img/bao/uploaded/i4/O1CN01LTXuHA1LSWntiFs6H_!!2135661298.jpg",
"promotion_price": "21.6",
"price": "21.6",
"sales": 3681,
"num_iid": "644898766440",
"post_fee": null,
"sample_id": "",
"seller_nick": null,
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=644898766440",
"cid": "50017261"
},
{
"title": "儿童羽毛球袜子毛巾底袜运动袜男童篮球袜中筒跑步短袜乒乓球女童",
"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01qvWYsU1Mw82go8a1p_!!2272921498.jpg",
"promotion_price": "18",
"price": "18",
"sales": 129,
"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"
}
],
"data_from": "app_t"
},
"error_code": "0000",
"reason": "ok",
"secache": "805dd061d51a733c7a85711ba0a36267",
"secache_time": 1667266730,
"secache_date": "2022-11-01 09:38:50",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 1,
"api_info": "today:32 max:10100 all[62=32+10+20];expires:2030-12-31",
"execution_time": "0.07",
"server_time": "Beijing/2022-11-01 09:39:31",
"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": "baidu",
"server_memory": "6.01MB",
"request_id": "gw-1.636078d3565a3",
"last_id": "1326062930"
}
