item_search-按关键字搜索商品 [查看演示]
amazon.item_search
公共参数
请求地址: https://api-gw.onebound.cn/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 items[] 0 按关键字搜索商品
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/amazon/item_search/?key=&secret=&q=鞋子&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="
响应示例
复制
{
"items": {
"ddf": "curry",
"item": [
{
"detail_url": "https://www.amazon.com/-/zh/dp/B07F8S18D5",
"num_iid": "B07F8S18D5",
"pic_url": "https://m.media-amazon.com/images/I/61srjyM7TFL._AC_UY218.jpg",
"price": "9.99",
"reviews": "53812",
"sales": 10000,
"stars": "4.7",
"title": "Nulaxy 双折叠手机支架,完全可调节可折叠桌面手机支架支架底座兼容手机 16 15 14 13 12 11 Pro Xs Max Xr X 8,Nintendo Switch,所有手机"
},
...
],
"page": "1",
"page_size": 100,
"pagecount": 7,
"q": "Mobile Phone Holder=",
"real_total_results": 700,
"total_results": 700
},
"error_code": "0000",
"reason": "ok",
"secache": "ec0173710acc6235de73975a9a1e7e0e",
"secache_time": 1736211646,
"secache_date": "2025-01-07 09:00:46",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:5 max:5000 all[11=5+3+3];expires:2025-12-18",
"execution_time": "1.817",
"server_time": "Beijing/2025-01-07 09:00:46",
"client_ip": "182.108.170.171",
"call_args": {
"q": "Mobile Phone Holder="
},
"api_type": "amazon",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.25MB",
"request_id": "1.677c7cbcbf29a",
"last_id": "3912698722"
}
异常示例
复制
{
"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": "amazon",
"request_id": "15ee0ffc041242"}