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=<您自己的apiKey>&secret=<您自己的apiSecret>&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"}