微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

新接口——邻家好货 API

item_search_neighbors-邻家好货  注册开通

onebound.taobao.item_search_neighbors

公共参数

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

请求参数

请求参数:num_iid=637798472116&seller_id=1091714097

参数说明:num_iid:商品ID
seller_id:卖家ID
不是每个商品都会返回邻家好货推荐

响应参数

Version: Date:

名称 类型 必须 示例值 描述
items item[] 0 邻家好货

请求示例

	
-- 请求示例 url 认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097"

响应示例

{
	"item": [
		{
			"num_iid": 565838198470,
			"price": 299,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/79444698/TB2Cepidf5TBuNjsspcXXbnGFXa_!!79444698.jpg",
			"title": "丝绒棒球服 ,实用收纳。   拉链短外套",
			"sales": 1,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=565838198470"
		},
		{
			"num_iid": 42489760538,
			"price": 170,
			"pic_url": "//img.alicdn.com/bao/uploaded/i4/TB1cxmXGpXXXXc3XVXXXXXXXXXX_!!0-item_pic.jpg",
			"title": "降E中音萨克斯 箱包 箱子 随行箱 包 背包 便携包 盒子硬包双肩背",
			"sales": 11,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=42489760538"
		},
		{
			"num_iid": 546919592592,
			"price": 98,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/2175450236/O1CN01vhmYzb1Dc8EL5Y6fE_!!2175450236.jpg",
			"title": "汽车摆件车内饰用品高档香水座弥勒佛男女士创意车载座式佛像高端",
			"sales": 10,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=546919592592"
		},
		{
			"num_iid": 3080762351,
			"price": 35,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/19833024751417871/T10XFEFnpcXXXXXXXX_!!0-item_pic.jpg",
			"title": "乐仔蒲公英泡泡水250ML与喇叭泡泡管  玉米糖浆吹泡泡液 早教玩具",
			"sales": 44,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=3080762351"
		},
		{
			"num_iid": 36051702918,
			"price": 228,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/TB16b95JXXXXXbPapXXXXXXXXXX_!!0-item_pic.jpg",
			"title": "德国设计 高端防滑汽车收纳箱 折叠车用后备箱 车载整理箱 储物箱",
			"sales": 137,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=36051702918"
		},
		{
			"num_iid": 569426237574,
			"price": 35,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/861420607/TB22MAtqN9YBuNjy0FfXXXIsVXa_!!861420607.jpg",
			"title": "六一儿童新品手工DIY制作粘贴首饰盒卡通kitty收纳盒女孩玩具礼物",
			"sales": 18,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=569426237574"
		},
		{
			"num_iid": 526280395803,
			"price": 117,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/2564709156/TB25l0HcC0mpuFjSZPiXXbssVXa_!!2564709156.jpg",
			"title": "森田高档欧式红外线瓦斯充气炉燃气不锈钢小火锅商用自助火锅配盖",
			"sales": 1,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=526280395803"
		},
		{
			"num_iid": 559147703285,
			"price": 3888,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/178364283/TB28urua2NNTKJjsspcXXb4KVXa_!!178364283.jpg",
			"title": "红木家具鸡翅木茶桌椅组合1.68到2米茶台实木新中式功夫茶桌茶几",
			"sales": 13,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=559147703285"
		},
		{
			"num_iid": 563057658042,
			"price": 278,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/240823272/TB2uODBjwLD8KJjSszeXXaGRpXa_!!240823272.jpg",
			"title": "欧洲站2022春夏新款圆头内增高小白鞋女单鞋厚底运动休闲透气网鞋",
			"sales": 39,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=563057658042"
		},
		{
			"num_iid": 564117864550,
			"price": 295,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/616625475/TB2RgTzd7fb_uJkSmLyXXcxoXXa_!!616625475.jpg",
			"title": "mlb棒球帽男女全黑色春夏ny鸭舌帽硬顶可调节休闲百搭经典la帽子",
			"sales": 7,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=564117864550"
		},
		{
			"num_iid": 541396198719,
			"price": 66,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/1505303/TB2tKfCcf6H8KJjsspmXXb2WXXa_!!1505303.jpg",
			"title": "精品秋冬加绒加厚条绒男童衬衫中大儿童纯棉灯芯绒衬衣上衣过年衣",
			"sales": 0,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=541396198719"
		},
		{
			"num_iid": 39529631083,
			"price": 75,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/TB1muhhFFXXXXX_bpXXXXXXXXXX_!!0-item_pic.jpg",
			"title": "嗓宝 SD-666T教学扩音器腰挂大功率教师导游小蜜蜂唱戏机 插卡U盘",
			"sales": 5,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=39529631083"
		},
		{
			"num_iid": 13951392457,
			"price": 37,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/95200406/TB2S4b.bHYI8KJjy0FaXXbAiVXa_!!95200406.jpg",
			"title": "芝竹堂盐袋子粗盐热敷包家用腰部热敷袋理疗袋海盐艾草灸微波盐包",
			"sales": 99,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=13951392457"
		},
		{
			"num_iid": 44333840340,
			"price": 310,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/1901206867/TB2ngxJgXXXXXaDXXXXXXXXXXXX_!!1901206867.jpg",
			"title": "泰国原装进口熟榴莲肉无核榴莲速冻榴莲肉3公斤金枕头非D24猫山王",
			"sales": 8,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=44333840340"
		},
		{
			"num_iid": 562576612813,
			"price": 29,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/650641826/TB29reOhYYI8KJjy0FaXXbAiVXa_!!650641826.jpg",
			"title": "大富翁游戏棋银牌铜牌世界中国台湾之旅上海滩强手棋娱乐桌游包邮",
			"sales": 4,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=562576612813"
		},
		{
			"num_iid": 553785471424,
			"price": 56,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/705717539/TB28Bs4x5RnpuFjSZFCXXX2DXXa_!!705717539.jpg",
			"title": "温胆汤泡脚包   千年古方湿气拜拜 10小包 罗大伦力荐",
			"sales": 33,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=553785471424"
		},
		{
			"num_iid": 17362617240,
			"price": 27,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/11211020902894265/T1pXdTXyJbXXXXXXXX_!!0-item_pic.jpg",
			"title": "真味兴无锡特产美食 马兰头 马兰拌香干 马兰菜 凉菜真空冰鲜顺丰",
			"sales": 22,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=17362617240"
		},
		{
			"num_iid": 555921467052,
			"price": 58,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/765984457/TB2g.9PckUkyKJjy1zjXXX1wFXa_!!765984457.jpg",
			"title": "跳跳马加大加厚小孩骑马平衡弹跳小马儿童充气橡胶玩具动物跳跳虎",
			"sales": 294,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=555921467052"
		},
		{
			"num_iid": 538682586516,
			"price": 68.8,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/1661448082/TB2uRoHXr2B11BjssplXXcMDVXa_!!1661448082.jpg",
			"title": "新款定做水晶办公摆件笔筒商务礼品桌面红旗党旗 水晶名片盒",
			"sales": 1,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=538682586516"
		},
		{
			"num_iid": 529375024987,
			"price": 36.26,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/17379926170/TB2DrmclhxmpuFjSZFNXXXrRXXa_!!17379926170.jpg",
			"title": "大号室内迷你乒乓球桌游戏折叠乒乓球台亲子桌面游戏娱乐竞技乒乓",
			"sales": 76,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=529375024987"
		},
		{
			"num_iid": 520569793066,
			"price": 88,
			"pic_url": "//img.alicdn.com/bao/uploaded/i3/TB1_ZRIHFXXXXXgXpXXXXXXXXXX_!!0-item_pic.jpg",
			"title": "八骏图十字绣2021新款线绣客厅大幅风景马到成功八匹马自己绣手工",
			"sales": 23,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=520569793066"
		},
		{
			"num_iid": 558759901800,
			"price": 168,
			"pic_url": "//img.alicdn.com/bao/uploaded/i2/712378249/TB28oWBhC3PL1JjSZFxXXcBBVXa_!!712378249.jpg",
			"title": "日本矫正坐姿护腰坐垫办公室久坐神器孕妇尾椎骨减压防驼背美臀垫",
			"sales": 6,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=558759901800"
		},
		{
			"num_iid": 551023888765,
			"price": 30,
			"pic_url": "//img.alicdn.com/bao/uploaded/i1/2860104054/TB2aRV7p3xlpuFjy0foxxa.lXXa_!!2860104054.jpg",
			"title": "加强u型单上衣产后收腹衣束腰产后收腹塑身衣微商恋柏尚俏姿同款",
			"sales": 13,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=551023888765"
		},
		{
			"num_iid": 540379908688,
			"price": 85,
			"pic_url": "//img.alicdn.com/bao/uploaded/i4/549233079/TB2rpfxX9OI.eBjy1zkXXadxFXa_!!549233079.jpg",
			"title": "泰国实木纸巾筒家居酒店卫生间卷纸筒厕所纸巾架 浴室厨房抽纸盒",
			"sales": 18,
			"tmall": "false",
			"detail_url": "https://item.taobao.com/item.htm?id=540379908688"
		}
	],
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:51 max:5000 all[72=51+16+5];expires:2023-04-25",
	"execution_time": "0.583",
	"server_time": "Beijing/2022-07-22 15:44:54",
	"client_ip": "106.6.33.140",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "4.58MB",
	"request_id": "gw-3.62da557602103",
	"last_id": "1094121365"
}

异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "4ee0ffc041242"
}

相关资料错误码解释

状态代码(error_code) 状态信息 详细描述 是否收费
0000 success 接口调用成功并返回相关数据
2000 Search success but no result 接口访问成功,但是搜索没有结果
4000 Server internal error 服务器内部错误
4001 Network error 网络错误
4002 Target server error 目标服务器错误
4003 Param error 用户输入参数错误 忽略
4004 Account not found 用户帐号不存在 忽略
4005 Invalid authentication credentials 授权失败 忽略
4006 API stopped 您的当前API已停用 忽略
4007 Account stopped 您的账户已停用 忽略
4008 API rate limit exceeded 并发已达上限 忽略
4009 API maintenance API维护中 忽略
4010 API not found with these values API不存在 忽略
4012 Please add api first 请先添加api 忽略
4013 Number of calls exceeded 调用次数超限 忽略
4014 Missing url param 参数缺失 忽略
4015 Wrong pagetoken 参数pagetoken有误 忽略
4016 Insufficient balance 余额不足 忽略
4017 timeout error 请求超时
5000 unkNown error 未知错误

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐