8f6f14da
 tangwang
test data prepare:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
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"}
|