淘宝/天猫同款商品搜索API接口详细演示

item_search_samestyle-搜索同款的商品 [查看演示] API测试工具 注册开通

onebound.taobao.item_search_samestyle

公共参数

请求地址: https://api-gw.onebound.cn/taobao/item_search_samestyle

名称	类型	必须	描述
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=-448629073&num_iid=547985308669&page=1&sort=&page_size=

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

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装	商品标题
pic_url	String	0	//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg	宝贝图片
promotion_price	Float	0	178.00	优惠价
price	Float	0	178.00	价格
sales	Int	0	890	销量
num_iid	Bigint	0	577437133060	宝贝ID
sample_id	String	0		商品风格标识ID
seller_nick	String	0	初穆旗舰店	掌柜昵称
post_fee	Float	0	10.00	物流费用
area	String	0	山东	店铺所在地
detail_url	String	0	//detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0	宝贝链接

请求示例

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

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

 代码展示

Result Object:
---------------------------------------
{
	"num_iid": "547985308669",
	"page": "1",
	"page_size": 13,
	"pagecount": 5,
	"total_results": 65,
	"item": [
		{
			"title": "白色很仙的防晒衣女夏季2022年新款宽松冰丝外套薄款透气连帽上衣",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i2/4183653021/O1CN016WB2QC1YBfC8xRLsu_!!0-item_pic.jpg",
			"original_price": "",
			"price": "55.00",
			"sales": "52",
			"num_iid": "644663956610",
			"shop_name": "夭领旗舰店",
			"seller_id": "4183653021",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=644663956610&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "白色防晒衣女中长款2022夏季新款薄款韩版洋气长款外套长袖防晒服",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/2209869377018/O1CN01oG9pff21iIF8PNcpd_!!0-item_pic.jpg",
			"original_price": "",
			"price": "139.00",
			"sales": "57",
			"num_iid": "636260330883",
			"shop_name": "爱妮芙旗舰店",
			"seller_id": "2209869377018",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=636260330883&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "2022年夏季薄款防晒衣女连帽开衫时尚百搭大码胖妹妹短款防晒服潮",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i2/738292971/O1CN01h8qNs31XolTPfU7fC_!!738292971.jpg",
			"original_price": "",
			"price": "178.00",
			"sales": "16",
			"num_iid": "669437497789",
			"shop_name": "诺儿服饰女装店",
			"seller_id": "738292971",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=669437497789&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "时尚防晒衣女款夏季2022新款冰丝防晒服户外透气轻薄外套防晒衫潮",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i3/2198046259/O1CN01LseS7o1w6fjACfYTU_!!0-item_pic.jpg",
			"original_price": "",
			"price": "128.00",
			"sales": "5",
			"num_iid": "674319363057",
			"shop_name": "dongluo冬诺旗舰店",
			"seller_id": "2198046259",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=674319363057&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "薄款防晒衣女款中长款2022夏季新款透气防晒服冰丝连帽遮阳防晒衫",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i2/2090278846/O1CN01QXbTi32FDWLtOPZQH_!!0-item_pic.jpg",
			"original_price": "",
			"price": "79.00",
			"sales": "13",
			"num_iid": "673259978534",
			"shop_name": "芭斯瑞旗舰店",
			"seller_id": "2090278846",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=673259978534&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "防晒衣女短款2022夏季新款轻薄防晒服空调衫宽松透气薄款女士外套",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/2209869377018/O1CN01CzVkr421iIF7h2KeB_!!0-item_pic.jpg",
			"original_price": "",
			"price": "128.00",
			"sales": "59",
			"num_iid": "635583204899",
			"shop_name": "爱妮芙旗舰店",
			"seller_id": "2209869377018",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=635583204899&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "【官网正品】防晒衣女夏季装2022年新款薄款衫女外套皮肤衣服长袖",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/2212670599060/O1CN01SMtoZ62GnX71x638G_!!0-item_pic.jpg",
			"original_price": "",
			"price": "198.00",
			"sales": "3",
			"num_iid": "675269070139",
			"shop_name": "诗歌小姐旗舰店",
			"seller_id": "2212670599060",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=675269070139&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "防晒衣女夏季2022年新款防紫外线透气轻薄冰丝upf50防晒服防晒衫",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i3/3360779468/O1CN01t5a4aT2JoOi1IFDFm_!!0-item_pic.jpg",
			"original_price": "",
			"price": "69.00",
			"sales": "0",
			"num_iid": "674290176610",
			"shop_name": "园帛旗舰店",
			"seller_id": "3360779468",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=674290176610&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "蕉下防晒衣女2022夏季新款中长款长袖防紫外线外套冰丝超薄款防晒",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/2212550847805/O1CN01DPm4Ba27Wk3N39ueI_!!2212550847805.jpg",
			"original_price": "",
			"price": "49.80",
			"sales": "1",
			"num_iid": "675205820774",
			"shop_name": "小颖商贸店",
			"seller_id": "2212550847805",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=675205820774&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "放晒衣服女超薄长款防晒透气百搭防紫外线2019新款防晒衣女潮流",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/2214104506676/O1CN011SvOz71zBetP3RyZo_!!2214104506676.jpg",
			"original_price": "",
			"price": "49.94",
			"sales": "0",
			"num_iid": "675319187799",
			"shop_name": "紫薇天喵店",
			"seller_id": "2214104506676",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=675319187799&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "ins超火防晒衣女2022流行夏季韩版中长款长袖防紫外线宽松超薄服1",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/3448171882/O1CN01WEjEia1PlzvYMhrsP_!!0-item_pic.jpg",
			"original_price": "",
			"price": "388.00",
			"sales": "0",
			"num_iid": "595314629732",
			"shop_name": "香港IT代购站",
			"seller_id": "3448171882",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=595314629732&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "正品进口防晒衣女中长款2022新款夏季薄款防紫外线仙女潮外套衫服",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i3/3448171882/O1CN01okr94Z1PlzvbU7yIV_!!3448171882.jpg",
			"original_price": "",
			"price": "399.50",
			"sales": "1",
			"num_iid": "595397205428",
			"shop_name": "香港IT代购站",
			"seller_id": "3448171882",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=595397205428&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		},
		{
			"title": "夏季防晒衣女2022新款户外透气骑车外套沙滩服薄款百搭防晒衫上衣",
			"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i1/3605447060/O1CN010yuMnq221WoeCkBhu_!!0-item_pic.jpg",
			"original_price": "",
			"price": "69.00",
			"sales": "0",
			"num_iid": "614615033180",
			"shop_name": "婉女郎旗舰店",
			"seller_id": "3605447060",
			"detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=614615033180&pvid=909b7433-3c8e-423b-b874-cb28247b6db0"
		}
	],
	"data_from": "app",
	"error": "data error,no cache",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "data error,no cache 接口文档：https://open.onebound.cn/help/api/taobao.item_search_samestyle.html",
	"error_code": "5000",
	"cache": 0,
	"api_info": "today:194 max:10100 all[303=194+49+60];expires:2030-12-31",
	"execution_time": "1.271",
	"server_time": "Beijing/2022-07-20 09:02:30",
	"client_ip": "106.6.35.38",
	"call_args": {
		"sample_id": "-448629073",
		"num_iid": "547985308669",
		"page": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "5.88MB",
	"request_id": "gw-3.62d754259b56c",
	"last_id": "1088657622"
}