XDataFly

亚马逊评论接口

按 ASIN 抓取亚马逊商品评论，支持星级筛选、排序方式、多站点与分页。返回评论 ID、评分、标题、正文、作者（已掩码）、是否 Verified Purchase 与有用票数。

1
积分 / 每页
GET/v1/amazon/reviews

请求参数

参数类型必填说明
asinstring必填10 位商品 ASINe.g. B0DXK317FN
page_countinteger可选需要抓取的评论页数，1-10，默认 1，按页计费e.g. 1
sortstring可选排序：recent / helpfule.g. recent
starstring可选星级筛选：all_stars / one_star … five_star / positive / criticale.g. all_stars
reviewer_typestring可选评审范围：all_reviews（全部）/ avp_only_reviews（仅已验证购买）e.g. all_reviews
media_typestring可选媒体类型：all_contents（全部）/ media_reviews_only（仅带图/视频的评论）e.g. all_contents
format_typestring可选格式范围：all_formats（全部格式）/ current_format（仅当前格式）e.g. all_formats
sitestring可选站点：amz_us / amz_uk / amz_de / amz_fr（当前支持 4 个站点）e.g. amz_us
include_mediaboolean可选是否返回评论图片/视频 URL，默认 false（体积较大）e.g. false

请求示例

bash
curl --location 'https://api.xdatafly.com/v1/amazon/reviews?asin=B0DXK317FN&page_count=1&sort=recent&star=all_stars&site=amz_us' \
  --header 'Accept: application/json' \
  --max-time 120 \
  --header 'secret-key: sk_live_xxxxxxxxxxxxxxxx'

返回示例

json
{
  "code": 0,
  "data": {
    "asin": "B0DXK317FN",
    "site": "amz_us",
    "reviews": [
      {
        "asin": "B0DXK317FN",
        "body": "Battery lasts all day and the fit is comfortable...",
        "title": "Sounds great",
        "author": "I***o",
        "rating": 5,
        "country": "United States",
        "review_id": "R3C2Q5J7C0DA76",
        "has_avatar": true,
        "vine_voice": false,
        "reviewed_at": "2026-05-23",
        "helpful_votes": 12,
        "verified_purchase": true
      }
    ],
    "total_reviews": 24318,
    "pages_returned": 1,
    "parser_version": "amazon.reviews:2026.10.2"
  },
  "usage": {
    "balance": 975,
    "credits": 25
  },
  "message": "ok",
  "request_id": "req_9b2c41de",
  "duration_ms": 5200
}
  • 单页通常需要 5–40 秒（上游实时抓取 Amazon），请把客户端超时设为 ≥60 秒 —— 默认 30 秒会误判为超时。
  • 按页计费：每页 1 积分（1 × page_count）。抓取失败的那一页不计费；超时或上游失败会全额解冻积分。
  • author 已做掩码处理（例如 I***o），以保证响应合规。
  • has_avatar 表示上游是否存在头像，但头像原图 URL 不返回。
  • include_media=true 会附带评论图片与视频 URL，响应体积明显增大。
  • total_reviews 是该 ASIN 在整个站点的评论总数，不只是本次抓取的页数。