item_search-按关键字搜索商品 前往注册开通测试
onebound.amazon.item_search
公共参数
名称 | 类型 | 必须 | 描述 |
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版本 |
请求参数
请求参数:q=鞋子&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=
参数说明:q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序
page:
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
items | item[] | 0 | 按关键字搜索商品 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/amazon/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=鞋子&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="
响应示例
{
"items": {
"url": "https://www.onebound.cn/s/ref=nb_sb_noss_2?__mk_zh_CN=%E4%BA%9A%E9%A9%AC%E9%80%8A%E7%BD%91%E7%AB%99&url=search-alias%3Daps&field-keywords=%E9%9E%8B%E5%AD%90&page=1",
"keyword": "鞋子",
"page": 1,
"real_total_results": "109553",
"total_results": 4400,
"item": [
{
"title": "Clarks Originals Trigenic Flex 休闲鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81oElE1OqML.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 258,
"num_iid": "B015DWSQ3W",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 男士Terracruise Lt低帮登山鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71-oiP8KhDL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 115,
"num_iid": "B07DTMGDBJ",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 男式 商务正装休闲皮鞋 Tilden Free 一脚蹬乐福鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81eyZpecUSL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 45,
"num_iid": "B00TTJJTBY",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks Men's Nature II Derbys 男士皮鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81NrXXjyBCL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 301,
"num_iid": "B002SNAYA8",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 女士Taylor Shine切尔西靴",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81F46OYGswL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 477,
"num_iid": "B01D1XDXDI",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 男士Irving德比鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71hrCMSvZ-L.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 45,
"num_iid": "B06Y1MYKHF",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Aigle 艾高 Tenere Light 女士高帮徒步远足鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81lpOg3p5YL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 23,
"num_iid": "B00SVDG4IA",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 Biom Fjuel男士跑鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/612w5-z38KL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 208,
"num_iid": "B00VJ32RGC",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Vans 范斯 Ward 女士绒面革/帆布低帮运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71qSCIK2uRL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 51,
"num_iid": "B078PH6WC2",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 男士Melbourne 粗皮鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71l-4hFjz2L.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 71,
"num_iid": "B076ZXM14W",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks Hamble Oak 女士皮鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71tQGQnlV7L.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 345,
"num_iid": "B0050N5DO0",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks Men's Derby 男士系带乐福鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71v+FEKfwmL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 39,
"num_iid": "B07F8Y4276",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Skechers Flex Advantage Sr 男士一脚蹬运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71H1LFFa2vL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 3,
"num_iid": "B07TVPNVHT",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 女士Linvale Jerica闭趾高跟鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61BZB7zXRzL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 18,
"num_iid": "B07B8VX1VJ",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 HELSINKI 男士 德比鞋 皮鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81uCulyo7ML.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 33,
"num_iid": "B001O9CNQK",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 男士Exostridem训练鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71f2+BDePaL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 64,
"num_iid": "B07MG97GZ6",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 欧文Irving系列 男式一脚蹬式便鞋 乐福鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61yIfAPZqIL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 15,
"num_iid": "B075JR8C1K",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 女士 Terracruise Lt 户外登山运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81jRl0XgawL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 29,
"num_iid": "B07DTH3MVB",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Gabor 女式时尚包头高跟鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/610QKuMbkdL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07Q32QW8B",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 男子Tilden Plain 德比牛津平底鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61+ilt1JVfL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 152,
"num_iid": "B00TTJHAQK",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 Soft 2 柔酷2号 女式胶底鞋 运动休闲鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81qNSisvieL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 9,
"num_iid": "B00V39NEXC",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Puma 彪马 Axis 中性成人运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71M6zM-zUOL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 19,
"num_iid": "B07F2Q6PXV",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 女式 Orinoco Club 切尔西靴",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/91g88Yv+9ML.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 91,
"num_iid": "B00475B8ZU",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Gabor 女士时尚高跟鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71fKlLnJoLL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07NSHGXQP",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks Vennor Walk 男士皮鞋 德比鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/51gYva3NXML.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 11,
"num_iid": "B075DLRK1B",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "4堂时尚搭配课:鞋子、包包、配饰、内衣",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/412aP-bgzXL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B0757LR5BZ",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "PUMA 彪马 Tazon 6 Fracture FM 男士运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61kyjQ9kFNL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 24,
"num_iid": "B01C3LK6DO",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "SAFERUNSAFERUN一次性鞋垫(女性用尺寸) 50双装 39(约24.5cm)根据鞋子的大小剪刀剪裁 吸收不适的汗水并保持鞋内干爽 纸鞋垫",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/51M8q0ip7AL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07S1B8S7S",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 男士 Becken Cap 德比鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/51+EeASfK+L.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 43,
"num_iid": "B07DPNB7GS",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "PUMA 彪马 中性款 Anzarun Lite Jr 运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71zMSgErQQL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07S8QCD6S",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "VANS 范斯 Filmore Decon 女式平底鞋 运动休闲鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/713cs0WdJRL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 27,
"num_iid": "B07FXQDNR8",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "2Toms 无臭鞋子和齿轮喷雾 - 消除汗液产生的异味(8 盎司瓶装)",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/7176k-rCxNL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 283,
"num_iid": "B003WPPC3K",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks 其乐 男士布洛克烤花 商务休闲皮鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61mu+HfBEdL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 38,
"num_iid": "B071WPJT5N",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Columbia 男士 Fairbanks 低帮运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81D02hrlBiL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 503,
"num_iid": "B07RJTKTWY",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Ecco 爱步 Exostride Summer Trail 男士户外运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71psAoAXlZL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 17,
"num_iid": "B07V9PR2RH",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Gabor 女士休闲浅口芭蕾舞鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61pVg2UBW6L.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07Q41LKVQ",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "HÖGL Ballerinas Boulevard 10 0-120014",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61QLwXIsAHL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 4,
"num_iid": "B00M65BY3E",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Kiwi Shoe Passion 女士凝胶鞋垫,隐形,防滑减震,1 双",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81vmIX6AKsL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B01HI8TG3S",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Gabor 女士舒适时尚包头高跟鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61zyVgZX8fL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 6,
"num_iid": "B07Q32W85Z",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "The Bridge Story Uomo 钱包 IV 皮革 10 厘米",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71ylTuyfDfL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B0093AZERC",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "ECCO 爱步 Men’s Exostrike Mid 户外男靴",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/8162OzezrLL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 56,
"num_iid": "B07C6894LM",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Merrell 男士 Move Glove 交叉训练鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71DSdhillpL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 44,
"num_iid": "B07KM3DBW2",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Harmonia bloom 鞋系列 [工作靴/黑色]",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61UQhHTccQL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B08WQ2891P",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Timberland 女士 Nellie 双重防水踝靴",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/81E8RF2nVhL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 316,
"num_iid": "B005JQS5F2",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Skechers 斯凯奇 女式 Synergy 2.0 重金属运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71TtAXOzOvL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B07GFGBB4J",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Nike 耐克 Wearallday 男士跑步鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/61-Hhmo3BYL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "B0838KJV9T",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Clarks Un系列 Aldric Park 男式皮鞋 德比鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/812lwANECgL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 83,
"num_iid": "B0756D885V",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "Skechers 斯凯奇 女士 Go Walk 5 -Limelight 一脚蹬运动鞋",
"pic_url": "https://images-cn.ssl-images-amazon.cn/images/I/71j+1cAjXEL.jpg",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 1,
"num_iid": "B07P29WJFW",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
},
{
"title": "",
"pic_url": "",
"price": "",
"promotion_price": "",
"price_range": null,
"sales": 0,
"num_iid": "",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": ""
}
],
"related_keywords": "",
"nav_catcamp": null,
"nav_filter": null
},
"error_code": "0000",
"reason": "ok",
"secache": "e299413c54b7d53e00a8046fc5bd7bdb",
"secache_time": 1615425986,
"secache_date": "2021-03-11 09:26:26",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 5.169,
"server_time": "Beijing/2021-03-11 09:26:26",
"client_ip": "106.6.35.144",
"call_args": {
"q": "鞋子"
},
"api_type": "amazon",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "2.99MB",
"request_id": "gw-3.604971be1ca59"
}
异常示例
{
"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": "15ee0ffc041242"}
相关资料错误码解释
状态代码(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 | 未知错误 | 否 |