Amazon Categories API

GET | POST /v1/amazon/categories

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

curl "https://gateway.apinoa.com/v1/amazon/categories" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数	类型	必填	说明
`categoryId`	string		Omit for the 40 departments; give a browse node (`172541`) or a department slug (`electronics`) to list that category's children. This is the one endpoint that takes either kind of id.
`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`

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 CategoryList。真实响应的节选：数组只保留前几项，长文本已截断。

{
  "success": true,
  "data": {
    "marketplace": "amazon",
    "path": [],
    "categories": [
      {
        "id": "amazon-devices",
        "name": "Amazon Devices & Accessories",
        "browsable": false
      },
      {
        "id": "amazon-renewed",
        "name": "Amazon Renewed",
        "browsable": false
      }
    ]
  }
}

错误

状态	代码	含义
400	`INVALID_PARAMS`	参数缺失、未知或超出范围。消息中会指出是哪一个。
401	`UNAUTHORIZED`	缺少 `x-api-key` 请求头，或密钥已吊销或未知。
402	`INSUFFICIENT_BALANCE`	余额不足以支付本次调用。请在控制台充值。
429	`MARKETPLACE_SATURATED`	并发调用过多。请等待 `Retry-After` 秒后重试。
502	`UPSTREAM_ERROR`	平台返回了无法使用的内容。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格每次调用 $0.001。标价；单日调用超过 1,000 次后单价下调。

说明

省略 categoryId 返回各部门。 传入一个 id 则列出其子类目，可逐层向下。
两种 id。 部门是店铺 slug（electronics）；部门以下都是数字浏览节点（172541）。部门返回 "browsable": false，因为 Browse 需要的是节点。向下一层，即可得到它接受的 id。
部门以下不报告 browsable，默认为可浏览；少数节点不列出任何商品（Camera & Photo 即是其一）。
响应包含 path（祖先类目，叶子在最后）和 categories。

Categories

请求

参数

响应

错误

价格

说明

本页内容