Browse
列出某个 Amazon 类目下的商品，无需关键词。
GET | POST /v1/amazon/browse参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。
请求
curl "https://gateway.apinoa.com/v1/amazon/browse?categoryId=679416011&priceMax=50&sort=price_asc" \
-H "x-api-key: $APINOA_API_KEY"参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | REQUIRED. An Amazon browse NODE — the digits from a category URL, e.g. 172541. The department slugs categories returns at its root (electronics) are NOT browse nodes and are refused with CATEGORY_NOT_BROWSABLE: call categories with the slug to get its child nodes and browse one of those. |
brands | string list | Brand names as Amazon spells them, e.g. brands=Nike,Adidas. A call that uses brands costs 2 units instead of 1. Not available on amazon.fr (region=FR). | |
facets | string | object list | Narrowings taken from a result's facets, e.g. facets=Color:Black. A call that uses facets costs 2 units instead of 1. Not available on amazon.fr (region=FR). | |
page | integer | 1-based page number; each page is charged separately. There is no pageSize (Amazon fixes the count per page, 13-47 in practice) and no cursor — paging is by number. | |
priceMax | number ≥ 0 | Highest price to return, in decimal major units. | |
priceMin | number ≥ 0 | Lowest price to return, in decimal major units. | |
ratingMin | number | 4 only. Amazon's rating filter offers exactly one threshold, "4 Stars & Up"; any other value is a 400 rather than a silently different search. Not available on amazon.fr (region=FR). | |
region | enum | Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR). US CA MX BR FR IT ES NL SE TR AE SA IN JP SG AU | |
sort | enum | Result ordering: best_match, price_asc, price_desc, newly_listed or avg_review. Defaults to best_match, Amazon's own relevance ordering. best_match price_asc price_desc newly_listed avg_review |
这些参数及所有响应类型也写在OpenAPI 文档中。
响应
在 data 中返回 SearchResult。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"success": true,
"data": {
"marketplace": "amazon",
"page": {
"index": 1,
"size": 0
},
"items": [],
"facets": []
}
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 400 | CATEGORY_NOT_BROWSABLE | 该类目是没有商品的导航层级。请从 categories 中选取其子类目进行浏览。 |
| 400 | INVALID_PARAMS | 参数缺失、未知或超出范围。消息中会指出是哪一个。 |
| 401 | UNAUTHORIZED | 缺少 x-api-key 请求头，或密钥已吊销或未知。 |
| 402 | INSUFFICIENT_BALANCE | 余额不足以支付本次调用。请在控制台充值。 |
| 429 | MARKETPLACE_SATURATED | 并发调用过多。请等待 Retry-After 秒后重试。 |
| 502 | UPSTREAM_ERROR | 平台返回了无法使用的内容。请退避后重试。 |
全部错误代码见 Errors。失败的调用不计费。
价格
价格 每次调用 $0.001，每多一次调用加 $0.001——最多再加 1 次，合计最多 $0.002。只有 brands 和筛选栏 facet 会增加一次：使用任一个即为 2 个单位。其他筛选不额外计费。标价；单日调用超过 1,000 次后单价下调。
说明
- 过滤器与
search相同，只是没有关键词。 传入query会返回 400，而不是被悄悄丢弃。有关键词时请使用 Search。 categoryId是浏览节点（679416011）。可从 Categories 获取；部门以下的每个节点都能列出商品。- 响应中没有
query键，其余与搜索响应完全相同。