万邦淘宝/天猫邻家好货 API 返回值说明

item_search_neighbors-邻家好货 [查看演示] API测试工具 注册开通

onebound.taobao.item_search_neighbors

公共参数

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

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

请求参数: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"
<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");

$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时,是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;

$api_data = $obapi->exec(
                array(
	                "api_type" =>"taobao",
	                "api_name" =>"item_search_neighbors",
	                "api_params"=>array (
  'num_iid' => '637798472116',
  'seller_id' => '1091714097',
)
                )
            );
 var_dump($api_data);
?>
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;

public class Example {
	private static String readAll(Reader rd) throws IOException {
		StringBuilder sb = new StringBuilder();
		int cp;
		while ((cp = rd.read()) != -1) {
			sb.append((char) cp);
		}
		return  sb.toString();
	}
	public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		conn.setDoOutput(true);
		conn.setDoInput(true);
		PrintWriter out = new PrintWriter(conn.getOutputStream());
		out.print(body);
		out.flush();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static void main(String[] args) throws IOException, JSONException {
		// 请求示例 url 默认请求参数已经URL编码处理
		String url = "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}
//using System.Net.Security;
//using System.Security.Cryptography.X509Certificates;
private const String method = "GET";
static void Main(string[] args)
{
	String bodys = "";
	// 请求示例 url 默认请求参数已经做URL编码
	String url = "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097";
	HttpWebRequest httpRequest = null;
	HttpWebResponse httpResponse = null; 
	if (url.Contains("https://"))
	{
		ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
		httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
	}
	else
	{
		httpRequest = (HttpWebRequest)WebRequest.Create(url);
	}
	httpRequest.Method = method;
	if (0 < bodys.Length)
	{
		byte[] data = Encoding.UTF8.GetBytes(bodys);
		using (Stream stream = httpRequest.GetRequestStream())
		{
		stream.Write(data, 0, data.Length);
		}
	}
	try
	{
		httpResponse = (HttpWebResponse)httpRequest.GetResponse();
	}
	catch (WebException ex)
	{
		httpResponse = (HttpWebResponse)ex.Response;
	}
	Console.WriteLine(httpResponse.StatusCode);
	Console.WriteLine(httpResponse.Method);
	Console.WriteLine(httpResponse.Headers);
	Stream st = httpResponse.GetResponseStream();
	StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
	Console.WriteLine(reader.ReadToEnd());
	Console.WriteLine("\n");
}
public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
{
	return true;
}
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)
响应示例
{
	"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) 状态信息 详细描述 是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误
API 工具
如何获得此API
立即开通 有疑问联系客服QQ:QQ:31424016063142401606(微信同号)