淘宝/天猫API:item_search_samestyle-搜索同款的商品

188 阅读4分钟

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

item_search_samestyle-搜索同款的商品

onebound.taobao.item_search_samestyle

公共参数

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

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:sample_id=-448629073&num_iid=547985308669&page=1&sort=&page_size=

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

响应参数

Version: Date:

名称类型必须示例值描述
titleString0法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装商品标题
pic_urlString0//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg宝贝图片
promotion_priceFloat0178.00优惠价
priceFloat0178.00价格
salesInt0890销量
num_iidBigint0577437133060宝贝ID
sample_idString0商品风格标识ID
seller_nickString0初穆旗舰店掌柜昵称
post_feeFloat010.00物流费用
areaString0山东店铺所在地
detail_urlString0//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="

响应示例

微信截图_20220803095346.png

获取key和secret

Result Object:

{ "num_iid": "547985308669", "page": "1", "page_size": 12, "pagecount": 5, "total_results": 60, "item": [ { "title": "白色很仙的防晒衣女夏季2022年新款宽松冰丝外套薄款透气连帽上衣", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "55.00", "sales": "28", "num_iid": "644663956610", "shop_name": "夭领旗舰店", "seller_id": "4183653021", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=644663956610&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "白色防晒衣女中长款2022夏季新款薄款韩版洋气长款外套长袖防晒服", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "136.00", "sales": "43", "num_iid": "636260330883", "shop_name": "爱妮芙旗舰店", "seller_id": "2209869377018", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=636260330883&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "2022年夏季薄款防晒衣女连帽开衫时尚百搭大码胖妹妹短款防晒服潮", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "178.00", "sales": "11", "num_iid": "669437497789", "shop_name": "诺儿服饰女装店", "seller_id": "738292971", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=669437497789&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "时尚防晒衣女款夏季2022新款冰丝防晒服户外透气轻薄外套防晒衫潮", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "125.00", "sales": "3", "num_iid": "674319363057", "shop_name": "dongluo冬诺旗舰店", "seller_id": "2198046259", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=674319363057&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "薄款防晒衣女款中长款2022夏季新款透气防晒服冰丝连帽遮阳防晒衫", "pic_url": "g.search.alicdn.com/img/bao/upl…", "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=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "防晒衣女短款2022夏季新款轻薄防晒服空调衫宽松透气薄款女士外套", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "125.00", "sales": "44", "num_iid": "635583204899", "shop_name": "爱妮芙旗舰店", "seller_id": "2209869377018", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=635583204899&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "放晒衣服女超薄长款防晒透气百搭防紫外线2019新款防晒衣女潮流", "pic_url": "g.search.alicdn.com/img/bao/upl…", "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=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "ins超火防晒衣女2022流行夏季韩版中长款长袖防紫外线宽松超薄服1", "pic_url": "g.search.alicdn.com/img/bao/upl…", "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=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "正品进口防晒衣女中长款2022新款夏季薄款防紫外线仙女潮外套衫服", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "399.50", "sales": "0", "num_iid": "595397205428", "shop_name": "香港IT代购站", "seller_id": "3448171882", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=595397205428&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "夏季防晒衣女2022新款户外透气骑车外套沙滩服薄款百搭防晒衫上衣", "pic_url": "g.search.alicdn.com/img/bao/upl…", "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=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "【官网正品】防晒衣女夏季装2022年新款薄款衫女外套皮肤衣服长袖", "pic_url": "g.search.alicdn.com/img/bao/upl…", "original_price": "", "price": "198.00", "sales": "1", "num_iid": "675269070139", "shop_name": "诗歌小姐旗舰店", "seller_id": "2212670599060", "detail_url": "//item.taobao.com/item.htm?scm=1007.29715.288050.0&id=675269070139&pvid=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" }, { "title": "防晒衣女夏季2022年新款防紫外线透气轻薄冰丝upf50防晒服防晒衫", "pic_url": "g.search.alicdn.com/img/bao/upl…", "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=344c8864-c6d4-4f9d-8fa9-5027cb14c73b" } ], "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 接口文档:open.onebound.cn/help/api/ta…", "error_code": "5000", "cache": 0, "api_info": "today:38 max:10100 all[58=38+6+14];expires:2030-12-31", "execution_time": "1.138", "server_time": "Beijing/2022-08-03 09:56:32", "client_ip": "106.6.35.126", "call_args": { "sample_id": "-448629073", "num_iid": "547985308669", "page": "1" }, "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "5.88MB", "request_id": "gw-1.62e9d5cf119e9", "last_id": "1124824020" }