Product
按 ASIN 获取单个 Amazon 商品：价格、变体、图片、规格、配送以及竞争报价汇总。
GET | POST /v1/amazon/product参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。
请求
curl "https://gateway.apinoa.com/v1/amazon/product?id=B07F3FFTMK" \
-H "x-api-key: $APINOA_API_KEY"参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | The marketplace's own product id, as carried by a search item. |
include | string | offers · offers:5 · offers:all — the enumerated competing-seller offers, which are fetched separately and so opt-in. Depth counts pages of offers (10 offers each) and each page is charged; all walks to the end, capped at 30 pages. | |
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 中返回 Product。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"success": true,
"data": {
"marketplace": "amazon",
"id": "B07F3FFTMK",
"url": "https://www.amazon.com/dp/B07F3FFTMK",
"title": "Mens Merino Wool Crew Socks Thermal and Warm Sock…",
"groupId": "B0BGFR76CF",
"deliveryTo": {
"label": "Edison 08817",
"country": "US",
"postalCode": "08817"
},
"features": [
"MAKE HIKING A COMFORTABLE EXPERIENCE These Merino…"
],
"brand": "Alvada",
"status": "In Stock",
"inStock": true,
"unitPrice": {
"price": {
"currency": "USD",
"amount": 4.5
},
"unit": "count"
},
"reviewAspects": [
{
"name": "quality",
"mentions": 4534,
"positive": 3976,
"negative": 558
}
],
"boxContents": [],
"returnsPolicy": "FREE 30-day refund/replacement",
"brandUrl": "https://www.amazon.com/stores/Alvada/page/C127B0C…",
"promotions": [],
"fulfilledBy": "Amazon",
"delivery": {
"estimate": "FREE delivery Thursday, October 29 on orders ship…",
"free": true,
"minimumOrder": {
"currency": "USD",
"amount": 35
},
"condition": "on orders shipped by Amazon over $35",
"minDays": 5,
"maxDays": 5
},
"shippingOptions": [
{
"estimate": "FREE delivery Thursday, October 29 on orders ship…",
"free": true,
"minimumOrder": {
"currency": "USD",
"amount": 35
},
"condition": "on orders shipped by Amazon over $35",
"minDays": 5,
"maxDays": 5
}
],
"badges": [
"Amazon's Choice"
],
"salesLabel": "10K+ bought in past month",
"salesCount": 10000,
"media": {
"images": [
"https://m.media-amazon.com/images/I/91aOC3G1W6L._…"
],
"videos": [
{
"url": "https://m.media-amazon.com/images/S/vse-vms-trans…",
"thumbnailUrl": "https://m.media-amazon.com/images/I/A16M+pgi4GL.S…",
"title": "Alvada wool socks: exceptional warmth and quality…",
"duration": "00:14"
}
]
},
"price": {
"currency": "USD",
"amount": 13.49
},
"listPrice": {
"currency": "USD",
"amount": 14.99
},
"rating": {
"average": 4.5,
"count": 37581,
"grouped": true,
"distribution": {
"1": 4,
"2": 2,
"3": 5,
"4": 11,
"5": 78
}
},
"category": [
{
"id": "7141123011",
"name": "Clothing, Shoes & Jewelry"
}
],
"seller": {
"name": "Alvada",
"id": "A12H3CME8AOYX8",
"url": "https://www.amazon.com/gp/help/seller/at-a-glance…"
},
"attributes": [
{
"name": "Fabric type",
"value": "80% Merino Wool, 15% Polyester, 4% Nylon, 1% Span…"
}
],
"options": [
{
"id": "size_name",
"name": "Size",
"values": [
{
"id": "size_name:Small-Medium",
"name": "Small-Medium"
}
]
}
],
"variants": [
{
"id": "B0GKGJZ323",
"productId": "B0GKGJZ323",
"selections": [
{
"optionId": "size_name",
"valueId": "size_name:Medium-Large",
"optionName": "Size",
"valueName": "Medium-Large"
}
]
}
],
"offers": [
{
"price": {
"currency": "USD",
"amount": 13.49
},
"listPrice": {
"currency": "USD",
"amount": 14.99
},
"seller": {
"name": "Alvada",
"id": "A12H3CME8AOYX8",
"url": "https://www.amazon.com/gp/help/seller/at-a-glance…"
},
"fulfilledBy": "Amazon",
"status": "In Stock",
"inStock": true,
"delivery": {
"estimate": "FREE delivery Thursday, October 29 on orders ship…",
"free": true,
"minimumOrder": {
"currency": "USD",
"amount": 35
},
"condition": "on orders shipped by Amazon over $35",
"minDays": 5,
"maxDays": 5
}
}
],
"reviews": [],
"identifiers": {
"gtin": "753610373339",
"mpn": "43528-95629",
"model": "Merino Wool Socks"
},
"reviewSummary": "Customers find these wool socks to be of good qua…",
"listedAt": "2022-08-10"
}
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 400 | INVALID_PARAMS | 参数缺失、未知或超出范围。消息中会指出是哪一个。 |
| 401 | UNAUTHORIZED | 缺少 x-api-key 请求头，或密钥已吊销或未知。 |
| 402 | INSUFFICIENT_BALANCE | 余额不足以支付本次调用。请在控制台充值。 |
| 404 | PRODUCT_NOT_FOUND | 该平台没有这个商品。 |
| 429 | MARKETPLACE_SATURATED | 并发调用过多。请等待 Retry-After 秒后重试。 |
| 502 | UPSTREAM_ERROR | 平台返回了无法使用的内容。请退避后重试。 |
全部错误代码见 Errors。失败的调用不计费。
价格
价格 每次调用 $0.002，每多一次调用加 $0.001——最多再加 30 次，合计最多 $0.032。只有 include=offers 会增加：每页十个报价计一个单位，最多 30 页。标价；单日调用超过 1,000 次后单价下调。
说明
- 搜索结果条目的
id就是 ASIN，因此搜索可以直接衔接到 product。请传入与搜索时相同的region：ASIN 会在该站点上以其货币查询。 include=offers列出竞争卖家。 商品始终带有汇总（offersSummary，例如 "New & Used (305) from $2.07"）。完整列表需主动开启，按每页十个报价计费，最多 30 页：
include | 价格 |
|---|---|
| 省略 | $0.002 |
offers | $0.003 |
offers:5 | 最多 $0.007 |
offers:all | 最多 $0.032（30 页） |
超出上限的请求会被截断，而不是拒绝。响应中的 ext.included 说明实际获取了哪些扩展。