淘宝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"
}