# Amazon 评价 API (amazon.reviews)

- Canonical page: https://everyinfra.com/amazon-api/reviews
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "amazon", "action": "reviews", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call (larger values are capped)
- Mode: sync; add "mode": "async" for slow tasks

Amazon 评价接口按商品链接读取买家评论，每条带标题、正文、评分、发布时间、被标「有帮助」的次数、是否已验证购买、是否 Vine 送测、购买的规格和评论者所在国家。它回答「买家对这件商品满意吗、具体在抱怨什么」，适合跨境选品、竞品痛点分析和自有商品的口碑监测。

`url` 用 /dp/<ASIN> 这样的商品链接，接口从中提取 ASIN；非美国站的商品要用 `domain` 指定和链接一致的站点。分析时给已验证购买的评价更高权重，`is_vine` 为真的是平台送测评价，需要单独标注；`variant` 能把反馈对应到具体规格。没有排序和翻页参数；各站点都只取得到商品页展示的精选评论，通常十几条，不是全部历史评价。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=amazon&action=reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Amazon 商品链接，例如 https://www.amazon.com/dp/<ASIN>。reviews 从 /dp/、/gp/product/ 或 /product-reviews/ 路径提取 10 位大写字母/数字 ASIN；不能用店铺首页代替。profile 在这里指商品详情，不是用户资料。 |
| domain | enum: amazon.ca / amazon.co.jp / amazon.co.uk / amazon.com / amazon.com.au / amazon.de / amazon.es / amazon.fr / amazon.in / amazon.it / amazon.sg | no | not declared | 评论所在的 Amazon 国家站点域名，默认 amazon.com；不要带 https://、www. 或页面路径，应与商品链接的站点一致。只支持 11 个站点：amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.it、amazon.es、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp、amazon.sg；传别的站点（例如 amazon.com.mx）扣费前回 422 invalid_value，并列出支持的站点。各站点都只能取到商品页展示的精选评论，每个商品通常十几条，取不到全部历史评论。目前美国站（amazon.com，也是不传 domain 时的默认站）取不到评论，因为这个站的评论要登录才能看，这类请求也不收费；同步调用通常返回 503 unavailable，error.reason 为 access_blocked。其他 10 个站照常；同一商品如果也在别的站卖（例如 amazon.ca、amazon.co.uk），可以改传那个站的 domain，拿到的是那个站的评论。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| review_id | 评价 ID。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| helpful_count | 评价被标「有帮助」次数。 |
| is_verified_purchase | 是否为已验证购买的评价。未验证的权重应打折。 |
| is_vine | 是否为 Vine 计划评价（平台送测，需标注）。 |
| variant | 规格变体。 |
| country | 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。 |
| url | 该记录在原平台上的可访问链接。 |
| author_name | 评论人公开显示的昵称（reviews），来自评论人公开资料，可能为空。 |
| author_id | 评论人的 Amazon 公开资料 ID（reviews），可能为空。 |
| author_avatar_url | 评论人公开资料里的头像链接（reviews），可能为空或是默认头像。 |
| product_asin | 商品 ASIN。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| images | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "reviews",
  "params": {
    "url": "https://www.amazon.com/dp/B09B8V1LZ3"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "amazon",
        "action": "reviews",
        "params": {
            "url": "https://www.amazon.com/dp/B09B8V1LZ3",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "amazon",
  "action": "reviews",
  "results": [
    {
      "review_id": "RKHY57N765VC1",
      "title": "Great Sound and Very Convenient",
      "text": "I’m very happy with this Echo Dot. The sound is clear and surprisingly powerful for its small size. It was easy to set up, and Alexa responds quickly to commands. I love using it to play music, set timers, ask questions, and control my smart devices. The compact design also looks…",
      "rating": 5,
      "posted_at": "2026-09-14T00:00:00+00:00",
      "helpful_count": 4,
      "is_verified_purchase": true,
      "is_vine": false,
      "variant": "Color: Charcoal",
      "country": "United States",
      "url": "https://www.amazon.com/gp/customer-reviews/RKHY57N765VC1",
      "product_asin": "B09B8V1LZ3",
      "platform": "amazon",
      "rating_scale": 5
    },
    {
      "review_id": "RD53PF5YDN90U",
      "title": "Excellent little smart speaker",
      "text": "“Excellent little smart speaker. The setup was quick and easy, and the sound quality is surprisingly good for its size. Alexa responds quickly and is very useful for music, reminders, timers, and controlling smart devices. It fits perfectly in a bedroom or office. Very happy with…",
      "rating": 5,
      "posted_at": "2026-09-24T00:00:00+00:00",
      "is_verified_purchase": true,
      "is_vine": false,
      "variant": "Color: Glacier White",
      "country": "United States",
      "url": "https://www.amazon.com/gp/customer-reviews/RD53PF5YDN90U",
      "product_asin": "B09B8V1LZ3",
      "platform": "amazon",
      "rating_scale": 5
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 非美国站的商品怎么读评价？

用 `domain` 指定站点，例如 amazon.co.uk、amazon.co.jp，并和商品链接的站点保持一致，不带 https:// 和路径。不传时默认 amazon.com，读别的站点的商品就会对不上。

### 哪些评价更可信？

优先看 `is_verified_purchase` 为真的评价，未验证的评价权重应打折；`is_vine` 为真的是 Vine 计划送测评价，应单独标注。`helpful_count` 高的评价通常更有代表性。

### `url` 能用店铺页吗？

不能。接口从 /dp/、/gp/product/ 或 /product-reviews/ 路径里提取 10 位的 ASIN，所以要传商品页或评论页链接；店铺首页和搜索页都读不到评价。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=amazon
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md