万邦淘宝/天猫搜索相似的商品 API 返回值说明

item_search_similar-搜索相似的商品

onebound.taobao.item_search_similar

公共参数

请求地址: console.open.onebound.cn/console/?i=… 注册享任意接口免费测试3天

名称	类型	必须	描述
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版本

请求参数

请求参数：sample_id=-1005300893&num_iid=527655087864&page=1&sort=&page_size=

参数说明：sample_id:商品风格标识ID
num_iid:商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	男装(UT) Pieter Ceizer印花T恤(短袖) 417197 优衣库UNIQLO	宝贝标题
pic_url	String	0	//g-search3.alicdn.com/img/bao/uploaded/i4/i3/196993935/O1CN01TAHkRs1ewH0Mxy6YU_!!0-item_pic.jpg	宝贝图片
promotion_price	String	0	99.00	优惠价
price	Float	0	99.00	价格
sales	Int	0	2125	销量
num_iid	Bigint	0	583658918441	宝贝ID
sample_id	String	0		商品风格标识ID
seller_nick	String	0	优衣库官方旗舰店	卖家
post_fee	Float	0	15.00	邮费
area	String	0	上海	区域
detail_url	String	0	//detail.tmall.com/item.htm?id=583658918441&ns=1	宝贝链接

请求示例

• [Curl]
• [PHP]
• [PHPsdk]
• [JAVA]
• [C#]
• [Python]

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_similar/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&sample_id=-1005300893&num_iid=527655087864&page=1&sort=&page_size="

响应示例

获取key和secret

Result Object:

{ "error": "", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "items": { "item": [ { "title": "AD YP 2020 短袖", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "179.00", "price": "179.00", "sales": 0, "num_iid": "644626195523", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "mz", "data_update": "2021-10-21 22:33:05" }, { "title": "清仓 捡漏 特价 T家 秋冬 欧美大码女装 纯棉 连帽风衣 外套", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "69.00", "price": "69.00", "sales": 19, "num_iid": "656386511645", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "mz", "data_update": "2021-10-23 09:21:06" }, { "title": "Madehero 原创 四条杠 短袖 T恤 Tee", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "219.00", "price": "219.00", "sales": 20000, "num_iid": "643049038182", "seller_nick": "tb689673883", "seller_id": "2207652549292", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-27 11:54:12" }, { "title": "#【T恤 针织点点提花弹力布料】 bjd袜子ob11娃衣 裤子 纯棉面料", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "7.20", "price": "8.00", "sales": 10000, "num_iid": "634922006707", "seller_nick": "滕依秋", "seller_id": "437829337", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-30 06:54:29" }, { "title": "#【T恤 莱卡布料】bjd娃衣 内衣内裤ob11袜子 提花条纹 针织面料", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "3.50", "price": "5.00", "sales": 20000, "num_iid": "590078395348", "seller_nick": "滕依秋", "seller_id": "437829337", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-27 22:56:39" }, { "title": "bjd古装娃衣 衣服 1/3 大女 古装 梓轻", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "385.00", "price": "385.00", "sales": 0, "num_iid": "602766762965", "seller_nick": "laingsheng", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-11-02 04:12:01" }, { "title": "优衣库 男装 优质长绒棉格子衬衫(长袖) 431471 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "149.00", "price": "149.00", "sales": 0, "num_iid": "618800109229", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 01:25:51" }, { "title": "链锯人周边电锯人动漫二次元短袖衣服半袖cos男女电次早川秋 T恤", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "45.00", "price": "90.00", "sales": 80000, "num_iid": "641729581992", "seller_nick": "弗罗猫旗舰店", "seller_id": "2057388085", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-30 01:47:55" }, { "title": "男装 优质长绒棉条纹立领衬衫(长袖) 427451 优衣库UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "607935720672", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 08:56:08" }, { "title": "TESTV夏季时尚穿搭周边秋季内衬穿搭宽松款T恤纯棉像素风LOGO T恤", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "129.00", "price": "129.00", "sales": 310000, "num_iid": "655124001832", "seller_nick": "aatoy值不值得买", "seller_id": "2212355371454", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 18:51:30" }, { "title": "精品彩色罗口 T恤 卫衣 手工diy材料辅料 miumiu的巧手妈妈", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "12.50", "price": "12.50", "sales": 0, "num_iid": "615918548649", "seller_nick": "baobeianqi520", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 10:20:41" }, { "title": "优衣库 男装/女装 折叠伞 420562 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "79.00", "price": "79.00", "sales": 200, "num_iid": "595863242238", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-19 19:14:20" }, { "title": "优衣库 男装 高级轻型羽绒茄克(外套) 419994 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i2…", "promotion_price": "499.00", "price": "499.00", "sales": 0, "num_iid": "597926017274", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 14:20:58" }, { "title": "北极绒纯棉睡衣女夏套装 短袖 清新女士2022年新款春秋季薄家居服", "pic_url": "img.alicdn.com/bao/uploade…", "promotion_price": "29.90", "price": "138.00", "sales": 63020000, "num_iid": "569130562809", "seller_nick": "海之蓝1122333", "seller_id": "2370448413", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-06-29 02:18:50" }, { "title": "3分4分BJD SD 娃娃 衣服 裤子★格仔直筒裤 (2色入)1/4,1/3,大叔", "pic_url": "//img.alicdn.com/imgextra/i1/12246024456635058/T1z3tkFlBaXXXXXXXX_!!0-item_pic.jpg", "promotion_price": "38.00", "price": "38.00", "sales": 10000, "num_iid": "25876908300", "seller_nick": "垚垚y", "seller_id": "755432246", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 08:54:02" }, { "title": "三四3分4分SD/BJD 娃娃 衣服/娃衣显好腿形拼接皮裤 1/4,1/3,大叔", "pic_url": "//img.alicdn.com/imgextra/i2/12246031218355815/T1VPjPFj8bXXXXXXXX_!!0-item_pic.jpg", "promotion_price": "78.00", "price": "78.00", "sales": 30000, "num_iid": "35488008457", "seller_nick": "垚垚y", "seller_id": "755432246", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 09:01:15" }, { "title": "韩版男短袖学生tops latest men s t-shirts clothes fashion t恤", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "5.50", "price": "5.50", "sales": 0, "num_iid": "629340097387", "seller_nick": "自达百货", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-10-20 21:53:01" }, { "title": "GSM海外代购21秋冬 Amiri 白色 男士 牛仔背带裤", "pic_url": "img.alicdn.com/bao/uploade…", "promotion_price": "10530.00", "price": "10530.00", "sales": 0, "num_iid": "651415667144", "seller_nick": "GaoGao海外潮流代购", "seller_id": "401588994", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2021-11-12 20:42:50" }, { "title": "男装【JW】2021年冬季新款中长格子呢大衣夹棉韩版潮流时尚外套男", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "139.99", "price": "139.99", "sales": 0, "num_iid": "663045637868", "seller_nick": "美伊正品折扣", "seller_id": "2018794071", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-29 18:32:27" }, { "title": "优衣库 女装 罗纹圆领T恤(短袖) 430872 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "624874625258", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-11-02 02:41:32" }, { "title": "折扣季 ZARA 新款 男装 冬季羊皮皮革棉服夹克外套 05479351800", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "499.00", "price": "499.00", "sales": 0, "num_iid": "637041775356", "seller_nick": "a洛蓝a", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 22:55:08" }, { "title": "时尚芭莎·男士 原：时尚男士芭莎 原邮发：02-701 2019年-第3期 期刊杂志订阅过刊过期杂志期刊书籍", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "20.00", "price": "20.00", "sales": 0, "num_iid": "654148264248", "seller_nick": "人天兀鲁思图书专营店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 23:48:48" }, { "title": "PT私人订制 Massimo Dutti 男装 海军蓝 120 支纱高纱织羊毛修身西装长裤 00065338400", "pic_url": "img.alicdn.com/imgextra/i2…", "promotion_price": "990.00", "price": "990.00", "sales": 0, "num_iid": "609338634634", "seller_nick": "massimodutti官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 00:54:33" }, { "title": "T恤 夏新款外贸女装宽松青春圆领短袖侧条弹力套头短款上衣18415", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "8.99", "price": "8.99", "sales": 20000, "num_iid": "645331665067", "seller_nick": "手气要nice", "seller_id": "341123576", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 18:01:15" }, { "title": "Star Wars T恤 星球大战 Darth Vader HK 绝地武士 纯棉 T-Shirt", "pic_url": "//img.alicdn.com/imgextra/i1/178265078/O1CN01H4vQcO1nNlowxy8x2_!!178265078.jpg", "promotion_price": "86.00", "price": "86.00", "sales": 240000, "num_iid": "579998435884", "seller_nick": "人一条", "seller_id": "178265078", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 12:51:53" }, { "title": "mini times toys P-004 1/6比例 潮流 性感皮衣皮裙套装 接单", "pic_url": "gw.alicdn.com/imgextra/TB…", "promotion_price": "50.00", "price": "50.00", "sales": 0, "num_iid": "576978542084", "seller_nick": "yuguishui725", "seller_id": "403321470", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-30 13:34:47" }, { "title": "2001太空漫游 T恤 2001A Space Odyssey Stanley Kubrick T-Shirt", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "86.00", "price": "86.00", "sales": 20000, "num_iid": "563483230195", "seller_nick": "人一条", "seller_id": "178265078", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 14:30:03" }, { "title": "优衣库 男装 高弹力DRY-EX吸湿排汗九分裤(抽绳) 429164 UNIQLO", "pic_url": "//img.alicdn.com/imgextra/i1/196993935/O1CN01HDvJ391ewHCIA15Kp_!!0-item_pic.jpg", "promotion_price": "99.00", "price": "99.00", "sales": 0, "num_iid": "620513834029", "seller_nick": "优衣库官方旗舰店", "seller_id": "196993935", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2021-11-21 23:59:38" }, { "title": "Melvins T恤 NIRVANA Dracula石人车库纯棉黑色印花短袖 T-Shirt", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "86.00", "price": "86.00", "sales": 0, "num_iid": "612954376210", "seller_nick": "人一条", "seller_id": "178265078", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 16:23:12" }, { "title": "纯棉 夏季女款条纹连衣裙撞色优雅时尚女式连帽中长款裙子运动风", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "64.50", "price": "64.50", "sales": 1, "num_iid": "677846047451", "seller_nick": "tb685929501", "seller_id": "2213339211839", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-07-14 23:03:33" }, { "title": "Supreme Paisley 2001 Vintage 腰果花 Box Logo Tee T恤 短袖", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "4999.00", "price": "4999.00", "sales": 0, "num_iid": "571646228405", "seller_nick": "国际东海岸", "seller_id": "1875255245", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 14:45:43" }, { "title": "犬夜叉 桔梗 巫女服 和服 cosplay服装 全套 动漫 衣服 女装 假发", "pic_url": "gw.alicdn.com/imgextra/TB…", "promotion_price": "83.00", "price": "98.00", "sales": 0, "num_iid": "522756317480", "seller_nick": "筷子闯马头", "seller_id": "2644559082", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-31 18:38:34" }, { "title": "高尔夫男款秋季吸汗休闲速干长袖 t恤 运动男长袖", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "168.00", "price": "168.00", "sales": 0, "num_iid": "653130837103", "seller_nick": "tb1984801058", "seller_id": "2206615175629", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-22 18:37:27" }, { "title": "男装 法兰绒格子衬衫(长袖) 421193 优衣库UNIQLO", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "611157949611", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 10:04:22" }, { "title": "【100%纯棉】夏季男士短袖T恤纯棉宽松大码中青年半袖男装打底衫", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "29.90", "price": "29.90", "sales": 0, "num_iid": "638745964656", "seller_nick": "慧华服饰2017", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 11:57:18" }, { "title": "优衣库 男装/女装/情侣装 可机洗宽松V领背心 443918/439928", "pic_url": "img.alicdn.com/bao/uploade…", "promotion_price": "149.00", "price": "149.00", "sales": 2000, "num_iid": "655292337972", "seller_nick": "", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 20:57:15" }, { "title": "摇滚新乐团 T恤 Beck Mongolian Chop Squad 动漫 T-Shirt", "pic_url": "//img.alicdn.com/imgextra/i4/178265078/O1CN01FqH9yJ1nNlulewlw4_!!178265078.jpg", "promotion_price": "86.00", "price": "86.00", "sales": 60000, "num_iid": "573535256060", "seller_nick": "人一条", "seller_id": "178265078", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-07-31 15:33:16" }, { "title": "旗袍夏装2015休闲改良唐装纯棉男装民族服装 修身 短袖 衣服", "pic_url": "gw.alicdn.com/imgextra/T1…", "promotion_price": "28.50", "price": "120.00", "sales": 0, "num_iid": "10647857385", "seller_nick": "梦晨旗袍唐装专卖", "seller_id": "59230847", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-29 11:38:25" }, { "title": "MADE BY RICK 原创 领口字母Logo 短袖 T恤 Tee", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "169.00", "price": "169.00", "sales": 0, "num_iid": "623048579706", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 16:42:28" }, { "title": "外贸新款Squid Game鱿鱼游戏 韩剧 印花 短袖 T恤", "pic_url": "img.alicdn.com/bao/uploade…", "promotion_price": "36.00", "price": "36.00", "sales": 66, "num_iid": "656181349808", "seller_nick": "贝佳科创", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 16:40:54" } ], "data_from": "item_search" }, "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:61 max:10100 all[86=61+10+15];expires:2030-12-31", "execution_time": "5.331", "server_time": "Beijing/2022-08-03 10:21:03", "client_ip": "106.6.35.126", "call_args": { "q": "短袖 纯棉 男装 T恤 男士 潮流 衣服" }, "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "1.04MB", "request_id": "gw-4.62e9db8a70ee9", "last_id": "1124876169" }